From 8feba88a9d4d36c6a45a2b5a6488a7f0769ed2b5 Mon Sep 17 00:00:00 2001 From: Chia Automation Date: Sun, 21 Jul 2024 00:12:46 +0000 Subject: [PATCH 1/4] New Crowdin translations by GitHub Action --- .../academy/academy-intro/academy-home.md | 311 ++ .../academy/academy-intro/academy-overview.md | 107 +- .../block-formation-basics.md | 22 +- .../blockchain-basics/coinset-basics.md | 14 +- .../blockchain-basics/consensus-basics.md | 14 +- .../blockchain-basics/security-basics.md | 14 +- .../blockchain-basics/timelord-basics.md | 32 +- .../academy/chialisp/chialisp-inner-puzzle.md | 78 +- .../academy/chialisp/chialisp-intro.md | 110 +- .../academy/chialisp/chialisp-signatures.md | 98 +- .../academy/chialisp/chialisp-smart-coin.md | 118 +- .../challenges-plot-filters.md | 54 +- .../plotting-farming/farming-overview.md | 66 +- .../academy/plotting-farming/first-plot.md | 30 +- .../current/academy/plotting-farming/pools.md | 48 +- .../current/academy/primitives/academy-cat.md | 97 + .../current/academy/primitives/academy-did.md | 89 + .../current/academy/primitives/academy-nft.md | 114 + .../academy/primitives/academy-offers.md | 98 + .../academy/primitives/primitives-overview.md | 106 + .../architecture/architecture-overview.md | 2 +- .../current/architecture/farmers.md | 2 +- .../current/architecture/full-nodes.md | 2 +- .../current/architecture/harvesters.md | 4 +- .../current/architecture/mempool.md | 59 +- .../current/architecture/timelords.md | 33 +- .../current/block-validation/block-format.md | 4 +- .../current/block-validation/block-rewards.md | 20 +- .../current/cli-reference/asic-hwvdf.md | 119 + .../current/cli-reference/cat-admin.md | 56 +- .../current/cli-reference/clawback.md | 12 +- .../current/cli-reference/cli.md | 31 +- .../current/cli-reference/custody-tool.md | 130 +- .../current/cli-reference/daos.md | 390 +- .../current/cli-reference/datalayer.md | 315 +- .../current/cli-reference/dids.md | 32 +- .../current/cli-reference/nfts.md | 18 +- .../current/cli-reference/offers.md | 9 +- .../current/cli-reference/plotters.md | 206 +- .../current/cli-reference/simulator.md | 14 +- .../current/cli-reference/vcs.md | 93 +- .../current/cli-reference/wallet.md | 99 +- .../current/coin-set-model/clvm-vs-evm.md | 20 +- .../current/coin-set-model/conditions.md | 60 +- .../current/coin-set-model/costs.md | 36 +- .../consensus/attacks-and-countermeasures.md | 4 +- .../current/consensus/challenges.md | 6 +- .../current/consensus/consensus-intro.md | 6 + .../current/consensus/foliage.md | 30 +- .../current/consensus/forks.md | 18 +- .../consensus/signage-and-infusion-points.md | 54 +- .../current/contribution/using-github.md | 243 ++ .../current/dev-guides-home.md | 375 +- .../current/docs-home.md | 331 +- .../current/farming/checking-farm-health.md | 34 +- .../current/farming/farming-basics.md | 14 +- .../farming/farming-compressed-plots.md | 42 +- .../current/farming/farming-many-machines.md | 16 +- .../current/farming/pool-farming.md | 34 +- .../current/getting-started/bridge-guide.md | 333 ++ .../current/getting-started/farming-guide.md | 59 +- .../current/getting-started/installation.md | 458 +- .../current/getting-started/introduction.md | 4 +- .../current/getting-started/testnets.md | 12 +- .../current/getting-started/timelords.md | 320 ++ .../current/getting-started/using-the-gui.md | 10 +- .../current/getting-started/wallet-guide.md | 109 +- .../constants-variables-notation.md | 32 +- .../green-paper/green-paper-abstract.md | 2 +- .../green-paper/green-paper-appendix.md | 53 +- .../green-paper/green-paper-introduction.md | 28 +- .../green-paper/green-paper-references.md | 58 +- .../green-paper/hash-and-vdf-chains.md | 22 +- .../green-paper/longest-chain-protocols.md | 8 +- .../current/green-paper/rational-attackers.md | 20 +- .../recovering-from-51-percent-attacks.md | 72 +- .../green-paper/the-chia-blockchain.md | 105 +- .../guides/cat/cat-creation-tutorial.md | 74 +- .../guides/cat/cat2-upgrade/cat2-issuance.md | 328 +- .../guides/cat/cat2-upgrade/cat2-snapshot.md | 19 +- .../current/guides/cat/cr-cat-tutorial.md | 104 +- .../clawback/clawback-primitive-guide.md | 40 +- .../guides/clawback/clawback-user-guide.md | 48 +- .../guides/crash-course/cats-offers-nfts.md | 4 + .../crash-course/chialisp-and-typescript.md | 38 +- .../current/guides/crash-course/chialisp.md | 2 +- .../guides/crash-course/intro-to-chialisp.md | 2 +- .../guides/crash-course/introduction.md | 22 +- .../current/guides/crash-course/signatures.md | 2 +- .../current/guides/crash-course/state.md | 13 + .../custody/custody-tool-description.md | 26 +- .../guides/custody/custody-tool-user-guide.md | 16 +- .../current/guides/custody/prefarm-audit.md | 6 +- .../current/guides/dao/dao-cli-guide.md | 12 + .../current/guides/dao/dao-known-issues.md | 15 +- .../guides/datalayer/datalayer-permissions.md | 24 +- .../guides/datalayer/datalayer-user-guide.md | 4 +- .../current/guides/nft/nft-bulk-mint.md | 27 +- .../current/guides/nft/nft-intro.md | 8 +- .../current/guides/observer-wallet-guide.md | 112 + .../current/guides/seeder-user-guide.md | 41 +- .../current/guides/simulator-user-guide.md | 9 +- .../guides/tutorials/custom-puzzle-lock.md | 2 +- .../current/guides/tutorials/offers-cli.md | 2 +- .../current/guides/tutorials/offers-gui.md | 2 +- .../guides/verifiable-credentials-guide.md | 91 +- .../walletconnect-developer-guide.md | 86 +- .../walletconnect/walletconnect-user-guide.md | 18 +- .../current/keys/keys-and-signatures.md | 2 +- .../current/plotting/moving-plots.md | 10 +- .../current/plotting/plotting-basics.md | 34 +- .../current/plotting/plotting-compression.md | 42 +- .../current/plotting/plotting-hardware.md | 36 +- .../current/plotting/plotting-how-to.md | 81 +- .../current/plotting/plotting-setup.md | 36 +- .../current/plotting/plotting-software.md | 100 +- .../current/plotting/ssd-endurance.md | 20 +- .../current/protocol/harvester-protocol.md | 2 + .../current/protocol/networking-protocol.md | 4 + .../current/protocol/peer-protocol.md | 2 + .../pool/pool-protocol-specification.md | 4 +- .../current/protocol/protocol.md | 20 +- .../current/protocol/wallet-protocol.md | 2 + .../reference-client/coin-selection.md | 48 +- .../reference-client/key-management.md | 2 +- .../resources/chia-farming-workload.md | 16 +- .../current/resources/faq.md | 260 +- .../current/resources/k-sizes.md | 55 +- .../current/resources/references.md | 1 + .../timelord-contest-rules.md | 72 + .../timelord-contest/timelord-contest.md | 87 + .../current/rpc-reference/daemon.md | 153 +- .../current/rpc-reference/daos.md | 142 +- .../current/rpc-reference/datalayer.md | 345 +- .../current/rpc-reference/dids.md | 112 +- .../current/rpc-reference/farmer.md | 64 +- .../current/rpc-reference/full-node.md | 3666 +++++++++++++++++ .../current/rpc-reference/harvester.md | 20 +- .../current/rpc-reference/nfts.md | 145 +- .../current/rpc-reference/offers.md | 219 +- .../current/rpc-reference/rpc.md | 27 +- .../current/rpc-reference/simulator.md | 46 +- .../current/rpc-reference/vcs.md | 50 +- .../current/rpc-reference/wallet.md | 658 +-- .../check-if-things-are-working.md | 10 +- .../current/troubleshooting/locating-keys.md | 97 + .../troubleshooting/logging-reference.md | 156 +- .../current/troubleshooting/node-syncing.md | 39 +- .../current/troubleshooting/timelords.md | 121 + .../current/walletconnect/general.md | 42 +- .../current/walletconnect/nfts.md | 62 +- .../current/walletconnect/offers.md | 6 +- 152 files changed, 10902 insertions(+), 3709 deletions(-) create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-home.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-cat.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-did.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-nft.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-offers.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/primitives-overview.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/contribution/using-github.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/bridge-guide.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/observer-wallet-guide.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/timelord-contest/timelord-contest-rules.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/timelord-contest/timelord-contest.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/locating-keys.md create mode 100644 i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/timelords.md diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-home.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-home.md new file mode 100644 index 0000000000..ab9c27d834 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-home.md @@ -0,0 +1,311 @@ +--- +title: 学院主页 +slug: /academy-home +--- + +import ChialispIntro from '@site/static/img/academy/Intro2Chialisp.png'; +import SmartCoins from '@site/static/img/academy/SmartCoins.png'; +import Signatures from '@site/static/img/academy/Signatures.png'; +import InnerPuzzles from '@site/static/img/academy/InnerPuzzles.png'; + +import Consensus from '@site/static/img/academy/consensus.png'; +import Timelords from '@site/static/img/academy/timelords.png'; +import BlockFormation from '@site/static/img/academy/forming-blocks.png'; +import CoinSetModel from '@site/static/img/academy/coin-set.png'; +import Security from '@site/static/img/academy/security.png'; + +import FarmingOverview from '@site/static/img/academy/farming-overview.png'; +import ChallengesPlotFilters from '@site/static/img/academy/challenges-plot-filters.png'; +import Pools from '@site/static/img/academy/pools.png'; +import CreatingYourFirstPlot from '@site/static/img/academy/Intro2Farming.png'; + +import PrimitivesOverview from '@site/static/img/academy/primitives.png'; +import NFTs from '@site/static/img/academy/nft.png'; +import CATs from '@site/static/img/academy/cat.png'; +import DIDs from '@site/static/img/academy/did.png'; + +欢迎来到Chia学院，这里是深入研究Chia区块链技术的学术中心。 在这个以快速数字化转型为特征的时代，本学院提供对Chia区块链的全面探索，剖析其技术细节、现实应用以及其安全数据处理的细微差别。 作为Chia学院的学生，将深入了解Chia区块链的核心概念和功能。 + +## 课程 + +以下是几门精选课程，涵盖从区块链技术基础到Chialisp和实现的具体内容。 课程可以按任意顺序学习，因此请随意探索。 + +--- + +#### Chialisp概述 + +
+ + +
+
+
+ Intro to Chialisp +
+
+ + + +
+
+
+ + +
+
+
+ Smart Coins +
+
+ + + +
+
+
+ + +
+
+
+ Signatures +
+
+ + + +
+
+
+ + +
+
+
+ Inner Puzzles +
+
+ + + +
+
+
+ + +
+ +--- + +#### 区块链基础 + +
+ + +
+
+
+ Consensus +
+
+ + + +
+
+
+ + +
+
+
+ Timelords +
+
+ + + +
+
+
+ + +
+
+
+ Block Formation +
+
+ + + +
+
+
+ + +
+
+
+ Coin-Set Model +
+
+ + + +
+
+
+ + +
+
+
+ Security +
+
+ + + +
+
+
+ + +
+ +--- + +#### 绘图与耕种 + +
+ + +
+
+
+ Farming Overview +
+
+ + + +
+
+
+ + +
+
+
+ Challenges & Plot Filters +
+
+ + + +
+
+
+ + +
+
+
+ Pools +
+
+ + + +
+
+
+ + +
+
+
+ Creating Your First Plot +
+
+ + + +
+
+
+ + +
+ +--- + +#### Primitives + +
+ + +
+
+
+ Primitives Overview +
+
+ + + +
+
+
+ + +
+
+
+ NFTs +
+
+ + + +
+
+
+ + +
+
+
+ DIDs +
+
+ + + +
+
+
+ + +
+
+
+ CATs +
+
+ + + +
+
+
+ + +
+ +--- + +## 课程运作方式 + +查看[学院概述](https://docs.chia.net/academy-overview)页面，了解课程的呈现和组织方式。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md index 03ae4ebb0c..724739abfb 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md @@ -1,89 +1,89 @@ --- -title: Academy Overview +title: 学院概述 slug: /academy-overview --- import Runnable from '@site/src/components/Runnable.tsx'; -The lesson pages in Chia Academy are thoughtfully designed to enhance the learning experience for students. Each lesson is organized in a user-friendly and visually appealing manner. The structure typically includes: +Chia学院的课程页面经过精心设计，以增强学生的学习体验。 每节课都以用户友好且视觉吸引的方式组织。 结构通常包括： --- -## Lesson title +## 课程标题 -Each lesson starts with a clear and descriptive title that informs students about the topic they are about to explore. +每节课以一个清晰且描述性的标题开始，告知学生他们将要探讨的主题。 --- -## Learning objectives +## 学习目标 -A set of specific learning objectives is provided at the beginning of the lesson. These objectives outline what students will be able to understand or do by the end of the lesson, setting clear expectations. +在课程开始时会提供一组具体的学习目标。 这些目标概述了学生在课程结束时能够理解或完成的内容，设定了明确的期望。 -- Learning Objective 1 -- Learning Objective 2 -- Learning Objective 3 +- 学习目标1 +- 学习目标2 +- 学习目标3 --- -## Content +## 内容 -The core content in each lesson is conveyed through structured, short format videos followed by scripts. This hybrid visual and text approach ensures accessibility and caters to diverse learning preferences. +每节课的核心内容通过结构化的短视频和脚本传达。 这种视觉和文本混合的方法确保了可访问性，适应了不同的学习偏好。 --- -## Script +## 脚本 -Each of the short format videos will be proceeded by the script used for creating the video. This written format ensures ease of translation catering to diverse learners. +每个短视频之后都会附有用于制作视频的脚本。 书面格式确保了翻译的便利性，适应了不同的学习者。
- Expand for the full script + 展开查看完整脚本 00:00 -This is an example of how the scripts will be provided including timestamps. +这是脚本提供的示例，包括时间戳。 00:20 -The timestamps are provided in set intervals and are formatted as `minutes:seconds` (`MM:SS`). +时间戳以设定的间隔提供，格式为`分钟:秒`（`MM:SS`）。
--- -## Common gotchas +## 常见问题 -While lessons are thoughtfully designed to facilitate learning, there are some common pitfalls or challenges that a learner might face. These will be described after the script for each lesson. +虽然课程经过精心设计以促进学习，但学习者可能会遇到一些常见的陷阱或挑战。 课程的这一部分会指出这些潜在的问题，并提供建议或解决方案。 -- **Gotcha 1:** Description of gotcha 1. -- **Gotcha 2:** Description of gotcha 2. -- **Gotcha 3:** Description of gotcha 3. +- **常见问题1:** 常见问题1的描述。 +- **常见问题2:** 常见问题2的描述。 +- **常见问题3:** 常见问题3的描述。 --- -## Knowledge check +## 知识检测 -Each lesson contains a brief self-assessment quiz designed to gauge learners' comprehension and retention of the video material. These assessments reinforce key concepts and help learners self-assess their understanding. +每节课程都包含一个简短的自我评估测验，旨在衡量学习者对视频材料的理解和记忆。 这些评估强化了关键概念，并帮助学习者自我评估他们的理解。 -The quiz section has two components, questions and answers. The questions contain lesson-applicable questions and the answers contain the corresponding answers. +测验部分有两个组成部分，问题和答案。 问题包含与课程相关的问题，答案包含相应的答案。 -Since this is a self assessment, you can of course skip the questions and go straight to the answers; but, we strongly recommend that you take the time to solve the question on your own before checking the answer. +由于这是一个自我评估，您当然可以跳过问题直接查看答案；但是，我们强烈建议您在查看答案之前花时间自己解决问题。 -:::tip Question 1 +:::tip 问题1 -What format is used for timestamps in the content scripts? +内容脚本中使用什么格式来表示时间戳？ :::
- Answer (expand when ready to see the answer) + 答案(当准备好查看答案时展开) -`MM:SS` or `minutes:seconds` +`MM:SS` 或者 `minutes:seconds`
-:::tip Question 2 +:::tip 问题2 -What is the serialized form of this Chialisp puzzle? +这个Chialisp谜题的序列化形式是什么？ ```chialisp (mod (arg1 arg2) (+ arg1 arg2)) @@ -93,7 +93,7 @@ What is the serialized form of this Chialisp puzzle?
- Answer (expand when ready to see the answer) + 答案(当准备好查看答案时展开) ```chialisp (+ 2 5) @@ -101,15 +101,15 @@ What is the serialized form of this Chialisp puzzle?
-:::tip Question 3 +:::tip 问题3 -What is the Chialisp puzzle for squaring a passed argument? +求传入参数的平方的Chialisp谜题是什么？ :::
- Answer (expand when ready to see the answer) + 答案(当准备好查看答案时展开) ```chialisp (mod (arg) @@ -124,35 +124,31 @@ What is the Chialisp puzzle for squaring a passed argument? --- -## Additional resources +## 附加资源 -Links to additional reading materials, videos, or external resources may be provided for learners who wish to delve deeper into the lessons subject. +为了帮助希望深入学习课程主题的学习者，可能会提供额外的阅读材料、视频或外部资源链接。 -### Runnable Chialisp and clvm plugins +### 可运行的Chialisp和clvm插件 -Runnable plugins are for Chialisp and clvm are provided with all applicable lessons. Take some time to familiarize yourself with the tools and learn how to best make use of them throughout the lessons. -Each plugin has a series of components: +所有适用的课程都提供了Chialisp和clvm的可运行插件。 花些时间熟悉这些工具，并学习如何在整个课程中最好地利用它们。 每个插件都有一系列组件： -**Language:** The language of the plugin (Chialisp or clvm) is in the top right corner. -**Solution:** The top section is the input or solution. -**Puzzle:** The bottom section is the puzzle. -**Run:** Each plugin has a play/run button to the right of the language identifier. -**Result:** After clicking run, the result of the puzzle appears below the puzzle. -**Cost:** After clicking run, the clvm cost of the puzzle is calculated and appears in the bottom right corner. -**Errors:** After clicking run, the plugin checks for and provides any errors in place of the result section. +**语言：** 插件的语言（Chialisp或clvm）位于右上角。 +**解决方案(Solution)：** 顶部部分是输入或解决方案。 +**谜题(Puzzle)：** 底部部分是谜题。 +**运行：** 每个插件在语言标识符右侧都有一个播放/运行按钮。 +**结果：** 单击运行后，谜题的结果将出现在谜题下方。 :::info -The plugins only validate the formatting and completeness of the code; they do not check for any potential exploits. +插件仅验证代码的格式和完整性；它们不检查任何潜在的漏洞。 ::: -#### Chialisp plugin +#### Chialisp 插件 -When clicking run, the puzzle will first be serialized into clvm (similar to the `run` command) then the solution will be passed into the serialized puzzle (similar to the `brun` command). -The below example is a Chialisp puzzle that squares the number passed as an argument. +单击运行时，谜题将首先被序列化为clvm（类似于 `run` 命令），然后解决方案将被传递到序列化谜题中（类似于 `brun` 命令）。 下面的示例是一个Chialisp谜题，它将传入的参数作为一个数字并返回其平方。 -Note the number `(5)` is used in the solution top section and the Chialisp formatted puzzle is entered in the puzzle bottom section. Clicking run on this puzzle will return `25` as the result. +注意解决方案顶部部分使用了数字 `(5)`，而 Chialisp 格式化的谜题被输入到谜题底部部分。 单击此谜题上的运行按钮将返回 `25` 作为结果。 @@ -167,12 +163,11 @@ Note the number `(5)` is used in the solution top section and the Chialisp forma -#### Clvm plugin +#### Clvm插件 -When clicking run, the solution will be passed into the serialized puzzle (similar to the `brun` command). -The below example uses the serialized puzzle from above that squares the number passed as an argument. +单击运行时，解决方案将被传递到序列化的谜题中（类似于`brun` 命令）。 下面的示例使用了上面序列化的谜题，将传入的参数作为一个数字并返回其平方。 -Note the number `(5)` is used in the solution top section and the serialized puzzle is entered in the puzzle bottom section. Clicking run on this puzzle will return `25` as the result. +注意解决方案顶部部分使用了数字 `(5)`，而序列化的谜题被输入到谜题底部部分。 单击此谜题上的运行按钮将返回 `25` 作为结果。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/block-formation-basics.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/block-formation-basics.md index c659de8e9f..ffc6105c82 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/block-formation-basics.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/block-formation-basics.md @@ -5,7 +5,7 @@ slug: /block-formation-basics In this lesson, we review the basics of block formation including the farmers role in validating transactions, forming blocks, and managing the mempool. -## Learning objectives +## 学习目标 - **Transaction Validation**: Learn how nodes validate transactions for inclusion in a block. - **Block Formation**: Understand farmers role in forming blocks. @@ -13,7 +13,7 @@ In this lesson, we review the basics of block formation including the farmers ro --- -## Content +## 内容
@@ -21,7 +21,7 @@ In this lesson, we review the basics of block formation including the farmers ro --- -## Script +## 脚本
@@ -45,7 +45,7 @@ and the relevant transactions are cleared from the mempool. In this way, transac --- -## Common gotchas +## 常见问题 - **Transaction Validation:** Transactions are validated by all nodes not only while blocks are being formed but also when the newly infused blocks are sent from peers, this eliminates a malicious actors ability from altering transactions even if they have the fastest timelord and have farmed the block. - **Block Formation vs Infusion:** Block formation is the process of combining proofs of space with transactions (the foliage) and is performed by the farmer while block infusion is the process of adding blocks to the chain itself and is performed by timelords. @@ -53,7 +53,7 @@ and the relevant transactions are cleared from the mempool. In this way, transac --- -## Knowledge check +## 知识检测 :::tip Question 1 - Transaction Validation @@ -94,10 +94,10 @@ False, it is timelords that **infuse** blocks to the chain and the role of full What is the Mempool? -A. Temporary storage on the network where transactions are queued before being confirmed. -B. The amount of system memory the blockchain can access. -C. The total size of all current plots on the network. -D. Another name for the chia blockchain database. +A. Temporary storage on the network where transactions are queued before being confirmed.\ +The amount of system memory the blockchain can access.\ +The total size of all current plots on the network.\ +Another name for the chia blockchain database. ::: @@ -111,9 +111,9 @@ A. Temporary storage on the network where transactions are queued before being c --- -## Additional resources +## 附加资源 -### Links +### 链接 - Transaction validation [overview](https://docs.chia.net/block-validation/#body-validation): dives into the requirements for validating the blocks body (which contains the transactions). - Block formation [overview](https://docs.chia.net/consensus-foliage): explores the intricacies of the full nodes role in block formation and when transaction blocks are formed. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/coinset-basics.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/coinset-basics.md index b147a35d00..d2fd74fc13 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/coinset-basics.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/coinset-basics.md @@ -5,7 +5,7 @@ slug: /coinset-basics In this lesson, we dive into the coinset model basics and learn what it means to spend a coin in Chia. -## Learning objectives +## 学习目标 - **Coin Contents**: Learn what data is stored in a coin. - **Coin Puzzle**: Understand the role of a coins puzzle. @@ -13,7 +13,7 @@ In this lesson, we dive into the coinset model basics and learn what it means to --- -## Content +## 内容
@@ -21,7 +21,7 @@ In this lesson, we dive into the coinset model basics and learn what it means to --- -## Script +## 脚本
@@ -72,7 +72,7 @@ the hash of the puzzle that contains the conditions, and the value of the coin. --- -## Common gotchas +## 常见问题 - **Coinset vs Account:** Chia adopts the coinset model where everything is a coin that has its own set of rules, more information about the coinset model can be found [here](https://docs.chia.net/coin-set-vs-account/). This differs from the account model which instead uses contracts (or accounts) to represent users balances and these balances are what is stored on the chain (as opposed to coins and those coins values). - **Puzzles:** All requirements for spending a coin are contained in the coins puzzle. These puzzles can be simple or complex and effect how, when, and by whom the coin can be spent. The coins puzzle must be determined at the coins creation and cannot be altered thereafter. @@ -80,7 +80,7 @@ the hash of the puzzle that contains the conditions, and the value of the coin. --- -## Knowledge check +## 知识检测 :::tip Question 1 - Coinset @@ -147,9 +147,9 @@ The coinset model. --- -## Additional resources +## 附加资源 -### Links +### 链接 - Detailed [coinset and account model comparisons](https://docs.chia.net/coin-set-vs-account/): details the differences between the coinset and account models including how these differences effect transactions. - Overview of [coin puzzles](https://docs.chia.net/coin-set-intro/#puzzles): overviews the role of a coins puzzle and the effect it has on the coins abiltiy to be spent. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/consensus-basics.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/consensus-basics.md index 5eb3f3aff1..289de75623 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/consensus-basics.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/consensus-basics.md @@ -5,7 +5,7 @@ slug: /consensus-basics In this lesson, we review the basics of consensus, the process by which to determine the true state of a blockchain. -## Learning objectives +## 学习目标 - **Farmers**: Understand the basic role of farmers in providing proofs of space. - **Timelords**: Understand the basic role of timelords in providing proofs of time. @@ -13,7 +13,7 @@ In this lesson, we review the basics of consensus, the process by which to deter --- -## Content +## 内容
@@ -21,7 +21,7 @@ In this lesson, we review the basics of consensus, the process by which to deter --- -## Script +## 脚本
@@ -52,7 +52,7 @@ This consensus method maintains trustless security through high-decentralization --- -## Common gotchas +## 常见问题 - **Proof of Space:** Chia relies on Proof of Space where the user stores deterministic x value tables in "plots" not to be confused with Proof of Capacity (PoC) where users store data of other network participants (like filecoin). - **Timelords:** Timelords play the role of issuing challenges, verifying proofs of space, and infusing blocks to the chain. Farmers submit their Proofs of Space to Timelords but it is the Timelords that infuse blocks. @@ -60,7 +60,7 @@ This consensus method maintains trustless security through high-decentralization --- -## Knowledge check +## 知识检测 :::tip Question 1 - Consensus Method @@ -130,9 +130,9 @@ What is the current (as of December 2023) ratio of plots that contain eligible p --- -## Additional resources +## 附加资源 -### Links +### 链接 - Consensus [detailed documentation](https://docs.chia.net/consensus-intro): details the Chia consensus including proofs of space and time, timelords, vdfs, and more. - Farming [basics](https://docs.chia.net/farming-basics): overviews the farming process and how to get started. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/security-basics.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/security-basics.md index ee6b3653b1..5d2ffc7bdd 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/security-basics.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/security-basics.md @@ -5,7 +5,7 @@ slug: /security-basics In this lesson, we learn the basic security implementations in Chia and how they protect users from bad actors. -## Learning objectives +## 学习目标 - **Decentralization**: Understand how a decentralized network enhances security and reduces attack options for bad actors. - **Coin Signatures**: Learn how coin signatures protect the users ability to spend the coins. @@ -13,7 +13,7 @@ In this lesson, we learn the basic security implementations in Chia and how they --- -## Content +## 内容
@@ -21,7 +21,7 @@ In this lesson, we learn the basic security implementations in Chia and how they --- -## Script +## 脚本
@@ -57,7 +57,7 @@ so you can be sure about what exactly a coin is going to do when it is spent. --- -## Common gotchas +## 常见问题 - **Decentralization:** The true decentralization of Chia greatly increases the economic costs associated with performing various attacks on Chia, protecting it from all scales of bad actors. - **Coin Signatures:** Ensuring that a coins solution requires signing ensures that only the intended user can spend the coin, this is an essential part of securing coins on Chia. @@ -65,7 +65,7 @@ so you can be sure about what exactly a coin is going to do when it is spent. --- -## Knowledge check +## 知识检测 :::tip Question 1 - Decentralization @@ -112,9 +112,9 @@ False, a custom-developed flavor of Lisp called Chialisp was developed to be use --- -## Additional resources +## 附加资源 -### Links +### 链接 - General [Security Overview](https://docs.chia.net/coin-set-security): overviews of Chia security and a review of potential attacks. - Overview of [Coin Signing](https://docs.chia.net/coin-set-security/#signing): reviews the purpose of signing and when it should be used for coins. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/timelord-basics.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/timelord-basics.md index be69213de2..354a62a205 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/timelord-basics.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/blockchain-basics/timelord-basics.md @@ -5,7 +5,7 @@ slug: /timelord-basics In this lesson, we dive into the role that Timelords play in the consensus by using VDFs to generate challenges. -## Learning objectives +## 学习目标 - **Proofs of Time**: Learn how Proofs of Time are created by timelords and what role they perform. - **Verifiable Delay Function (VDF)**: Understand the basics of VDFs. @@ -13,7 +13,7 @@ In this lesson, we dive into the role that Timelords play in the consensus by us --- -## Content +## 内容
@@ -21,7 +21,7 @@ In this lesson, we dive into the role that Timelords play in the consensus by us --- -## Script +## 脚本
@@ -53,7 +53,7 @@ While at least one Timelord is required for the blockchain to function, anyone c --- -## Common gotchas +## 常见问题 - **VDFs and Proofs of Time:** A Verifiable Delay Function, also referred to as a Proof of Time or VDF, is a proof that a sequential function was executed a certain number of times. - **Timelords:** Only 1 timelord is needed to keep the chain moving but anyone can run a timelord and multiple timelords on the network ensures resiliency. Some attacks that timelords protect against are documented [here](https://docs.chia.net/consensus-attacks#faster-timelord). @@ -61,15 +61,15 @@ While at least one Timelord is required for the blockchain to function, anyone c --- -## Knowledge check +## 知识检测 :::tip Question 1 - Timelords How many Farmers need to run a Timelord for the network? -A. Every Farmer needs to run a Timelord. -B. At least half the Farmers need to run a Timelord. -C. Farmers aren't able to run Timelords. +A. Every Farmer needs to run a Timelord.\ +At least half the Farmers need to run a Timelord.\ +Farmers aren't able to run Timelords.\ D. Just one Timelord is needed for the network. ::: @@ -105,10 +105,10 @@ A. Timelords What are the primary purposes of VDFs? (choose all that apply) -A. To slow down the network. -B. To prove time has passed between blocks. -C. Provide security to the network. -D. Prepare for time travel integrations. +A. To slow down the network.\ +B. To prove time has passed between blocks.\ +Provide security to the network.\ +Prepare for time travel integrations. ::: @@ -116,8 +116,8 @@ D. Prepare for time travel integrations. Answer (expand when ready to see the answer) -B. To prove time has passed between blocks. -C. Provide security to the network. +B. To prove time has passed between blocks.\ +Provide security to the network.
@@ -139,9 +139,9 @@ True --- -## Additional resources +## 附加资源 -### Links +### 链接 - Timelords [detailed documentation](https://docs.chia.net/timelord-algorithm/): details the timelords role in the consensus model. - Proofs of Time / VDFs [overview](https://docs.chia.net/proof-of-time/): detailed overview for Proofs of Time and VDFs. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md index cdb027cae6..882f6483a9 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md @@ -5,16 +5,16 @@ slug: /chialisp-inner-puzzle import Runnable from '@site/src/components/Runnable.tsx'; -In this lesson, we'll talk about why you might want to nest puzzles and how to set them up. +在这节课上，我们将讨论为什么您可能希望嵌套谜题以及如何设置它们。 -## Learning objectives +## 学习目标 -- **Functions**: Learn how to define and execute functions in Chialisp. -- **Nesting Puzzles**: Understand the use of nesting puzzles in Chialisp. +- **函数（Functions）**：学习如何在 Chialisp 中定义和执行函数。 +- **嵌套谜题（Nesting Puzzles）**：了解在 Chialisp 中使用嵌套谜题的用途。 --- -## Content +## 内容
@@ -22,72 +22,72 @@ In this lesson, we'll talk about why you might want to nest puzzles and how to s --- -## Script +## 脚本
Expand for the full script 00:00\ -All puzzles result in the output of a condition that tells a blockchain what to do with a coin that it's wrapped in. Inner puzzles can be thought of as a coin within a coin where the result is a condition that is passed to the outer puzzle which executes it. +所有的谜题都会产生一个条件输出，告诉区块链在其中包装的硬币该做什么。 内部谜题可以看作是硬币中的硬币，结果是一个传递给外部谜题并由其执行的条件。 00:20\ -One specific use for this functionality is if you wanted to use a generic inner puzzle and wrap it in an outer puzzle that verifies a signature. The outer puzzle can be a sort of template that you can pass in any generic inner puzzle and it will be signature protected by the outer puzzle. Let's create this exact outer puzzle template. +这种功能的一个特定用途是，如果你想使用一个通用的内部谜题，并将其包装在一个验证签名的外部谜题中。 外部谜题可以看作是一种模板，你可以将任何通用的内部谜题传递进去，它将由外部谜题保护。 让我们创建这个外部谜题模板。 00:40\ -We're going to define a module, and for our parameters we'll have a `PUBLIC_KEY` that we'll curry in later, an `INNER_PUZZLE` that we'll also curry in, and then the `inner_solution`. We'll include the `condition_codes.clib` library file and the `sha256tree.clib` library file as well. Then, we're going to define a new function. +我们要定义一个模块，对于我们的参数，我们将有一个稍后传入的 `PUBLIC_KEY`，一个我们也将传入的 `INNER_PUZZLE`，然后是 `inner_solution`。 我们还将包含 `condition_codes.clib` 和 `sha256tree.clib` 库文件。 然后，我们将定义一个新的函数。 01:00\ -We'll call this `calculate_output` and in the parameters we'll have our `PUBLIC_KEY`, the `inner_solution`, and the `conditions` that we'll execute. In a combine statement, we'll have the standard signature verification that we used in the previous video. (`(defun calculate_output (PUBLIC_KEY inner_solution conditions) (c (list AGG_SIG_MET PUBLIC_KEY (sha256tree inner_solution)) conditions))`) +我们将其命名为 `calculate_output`，在参数中我们将有我们的 `PUBLIC_KEY`，`inner_solution`，以及我们将执行的 `conditions`。 在一个组合语句中，我们将使用之前视频中使用的标准签名验证。 (`(defun calculate_output (PUBLIC_KEY inner_solution conditions) (c (list AGG_SIG_MET PUBLIC_KEY (sha256tree inner_solution)) conditions))`) 01:20\ -For the message that we're verifying, we'll be verifying the `inner_solution` and then we'll return the `conditions`. Now that we've defined our new function, we'll call it with `calculate_output`, provide the `PUBLIC_KEY` and the `inner_solution`, and then we'll use the `apply` operator or `a` on our `INNER_PUZZLE`, providing the `inner_solution`. (`calculate_output PUBLIC_KEY inner_solution (a INNER_PUZZLE inner_solution)`) +对于我们要验证的消息，我们将验证 `inner_solution`，然后返回 `conditions`。 现在我们已经定义了我们的新函数，我们将使用 `calculate_output` 调用它，提供 `PUBLIC_KEY` 和 `inner_solution`，然后我们将对我们的 `INNER_PUZZLE` 使用 `apply` 运算符或 `a`，提供 `inner_solution`。 (`calculate_output PUBLIC_KEY inner_solution (a INNER_PUZZLE inner_solution)`) 01:40\ -The `apply` operator is how you execute some code. So the `INNER_PUZZLE` will be executed with the `inner_solution`. So this puzzle will first evaluate the inner puzzle with the `(a INNER_PUZZLE inner_solution))` method, and use the result as the condition for our `calculate_output` function. +`apply` 运算符是执行一些代码的方式。 因此，`INNER_PUZZLE` 将使用 `inner_solution` 执行。 因此，这个谜题将首先使用 `(a INNER_PUZZLE inner_solution))` 方法评估内部谜题，并将其结果用作我们的 `calculate_output` 函数的条件。 02:00\ -This function requires a signature of the `inner_solution` to pass. Now let's write the inner puzzle. For this puzzle, we're going to use a condition called `ASSERT_HEIGHT_RELATIVE`, which specifies when a coin can be spent, based on the number of blocks passed since coin creation. We'll define a module and in our parameters, we'll curry in the `REQUIRED_BLOCKS`. This will be a number of blocks that have to pass before the coin can be spent. +这个函数需要 `inner_solution` 的签名才能通过。 现在让我们编写内部谜题。 对于这个谜题，我们将使用一个称为 `ASSERT_HEIGHT_RELATIVE` 的条件，它指定了基于自硬币创建以来经过的块数的硬币何时可以被花费。 我们将定义一个模块，在我们的参数中，我们将传入 `REQUIRED_BLOCKS`。 这是一个必须经过的块数，硬币才能被花费。 02:20\ -Then, we'll have our `conditions`. We'll include the `condition_codes.clib` library again, and then we'll define a statement that uses the `ASSERT_HEIGHT_RELATIVE` condition on the `REQUIRED_BLOCKS` that we curried in, and then we'll return the `conditions`. +然后，我们将有我们的 `conditions`。 我们再次包含 `condition_codes.clib` 库文件，然后我们将定义一个语句，该语句使用我们传入的 `REQUIRED_BLOCKS` 上的 `ASSERT_HEIGHT_RELATIVE` 条件，然后我们将返回 `conditions`。 02:40\ -All right, now we have both our inner puzzle and our outer puzzle. Let's curry in the needed values. First we'll get our public key with `chia keys show`, and then we'll curry the block value into the inner puzzle with `cdv clsp curry inner-puzzle.clsp -a` and specify the number of blocks that we want to pass. +好了，现在我们有了内部谜题和外部谜题。 让我们传入所需的值。 首先，我们使用 `chia keys show` 获取我们的公钥，然后我们将块值传入内部谜题，使用 `cdv clsp curry inner-puzzle.clsp -a` 并指定我们想要经过的块数。 03:00\ -In this case, we'll use `20`. We can now curry this result, along with our public key, into the outer puzzle with `cdv clsp curry outer-puzzle.clsp -a`, enter our public key, `-a` and in quotes we'll paste the compiled inner puzzle. +在这种情况下，我们将使用 `20`。 现在我们可以将此结果与我们的公钥一起传入外部谜题，使用 `cdv clsp curry outer-puzzle.clsp -a`，输入我们的公钥，`-a`，然后在引号中粘贴编译后的内部谜题。 03:20\ -Now that we have our final compiled puzzle, we can go ahead and create a coin using the process that we covered in the last video. Once the coin has been created, we can create our solution for this coin. First we get our wallet address and `decode` it. We'll use this in our desired solution. Again, we'll be using the `CREATE_COIN` condition signified by the code `51`. +现在我们有了最终的编译谜题，我们可以继续创建一个硬币，使用我们在上一个视频中介绍的流程。 一旦硬币被创建，我们就可以为这个硬币创建解决方案。 首先我们获取我们的钱包地址并进行 `decode`。 我们将在我们想要的解决方案中使用这个地址。 同样，我们将使用代码 `51` 表示的 `CREATE_COIN` 条件。 03:40\ -Note that I'm nesting the solution in four (4) sets of parentheses. This is because the outer puzzle parameters list is passed in wrapped with parentheses as is the inner solution. In the inner puzzle, we have another set of parentheses for the list of conditions, and each condition is also wrapped. +注意，我将解决方案嵌套在了4组括号中。 这是因为外部谜题参数列表被包裹在括号中，内部解决方案也是如此。 在内部谜题中，我们有另一组括号用于条件列表，并且每个条件也被包裹在其中。 04:00\ -It's important to understand the structure of the puzzle to make sure that the solution you provide is structured properly. Now we'll add the encoded solution into our spend bundle where we already have the coin info and puzzle reveal from coin creation. Next, we'll get our signature using the method we outlined in the previous video. We'll hash our solution and concatenate it with the coin ID and genesis challenge. +了解谜题的结构非常重要，以确保您提供的解决方案结构正确。 现在我们将编码的解决方案添加到我们的花费包中，其中已经包含了来自硬币创建的硬币信息和谜题展示。 接下来，我们将使用我们在上一个视频中概述的方法获取我们的签名。 我们将解决方案进行哈希处理，然后将其与硬币 ID 和起源挑战进行连接。 04:20\ -Now we can sign the resulting message with `chia keys sign` and copy the signature into our spend bundle, being sure to append `0x` to signify that it's a value. Now run `cdv rpc pushtx spendbundle.json`. +现在我们可以使用 `chia keys sign` 对结果消息进行签名，并将签名复制到我们的花费包中，确保附加 `0x` 以表示它是一个值。 现在运行 `cdv rpc pushtx spendbundle.json`。 04:40\ -If the number of blocks is not yet passed, it will have a pending status. If successful, we can look up the coin record again and see that the spent block index is more than 20 blocks later than the confirmed block index. In this video, we learned how inner puzzles work and how they interact with outer puzzles. Thanks so much for watching, catch you next time. +如果块数尚未经过，它将显示为挂起状态。 如果成功，我们可以再次查找硬币记录，并查看已花费的块索引比确认的块索引晚了 20 个块。 在这个视频中，我们学习了内部谜题的工作原理以及它们与外部谜题的交互。 非常感谢观看，下次再见。
--- -## Common gotchas +## 常见问题 -- **More Parentheses:** It's important to take note of where your solutions are going to be used in your puzzle and wrap them in the appropriate amount of parentheses. This can be counter-intuitive as the parentheses can seem unecessary at first glance. +- **更多的括号**：重要的是要注意你的解决方案将在谜题中的哪里使用，并用适当数量的括号将它们包裹起来。 这可能有些反直觉，因为乍一看，括号似乎是不必要的。 --- -## Knowledge check +## 知识检测 -:::tip Question 1 - Evaluating Inner Puzzles +:::tip 问题1 - 评估内部谜题 -What operator is used to evaluate a puzzle within another puzzle? +什么运算符用于评估另一个谜题中的谜题？ ::: @@ -95,7 +95,7 @@ What operator is used to evaluate a puzzle within another puzzle? Answer (expand when ready to see the answer) -The `apply` operator. (`a`) +`apply`运算符。 (`a`) ```chialisp (a INNER_PUZZLE inner_solution) @@ -103,9 +103,9 @@ The `apply` operator. (`a`)
-:::tip Question 2 - A New Condition +:::tip 问题2 - 一个新条件 -What does the `ASSERT_HEIGHT_RELATIVE` condition check for? +`ASSERT_HEIGHT_RELATIVE` 条件检查什么？ ::: @@ -113,19 +113,19 @@ What does the `ASSERT_HEIGHT_RELATIVE` condition check for? Answer (expand when ready to see the answer) -`ASSERT_HEIGHT_RELATIVE` checks for how many blocks have passed since coin creation. It allows the resolution of a puzzle after a predefined number of blocks have passed. +`ASSERT_HEIGHT_RELATIVE` 检查自货币创建以来经过了多少个区块。 它允许在预定义数量的区块经过后解决谜题。
--- -## Additional resources +## 附加资源 -### Runnable Chialisp and clvm plugins +### 可运行的Chialisp和clvm插件 -For information on using these plugins please refer to the [academy overview](/academy-overview#runnable-chialisp-and-clvm-plugins) +有关使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins)。 -#### Chialisp plugin +#### Chialisp 插件 @@ -137,7 +137,7 @@ For information on using these plugins please refer to the [academy overview](/a -#### Clvm plugin +#### Clvm插件 @@ -147,11 +147,11 @@ For information on using these plugins please refer to the [academy overview](/a -### Links +### 链接 -- General [chialisp concepts](https://docs.chia.net/guides/chialisp-concepts): overviews of currying, inner puzzles, and morphing conditions. -- Guided [chialisp walkthroughs](https://docs.chia.net/guides/): guides for installation, creating smart coins, and working with BLS signatures. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. +- [Chialisp基本概念](https://docs.chia.net/guides/chialisp-concepts)：包括柯里化（currying）、内部谜题（inner puzzles）和条件变换（morphing conditions）的概述。 +- 指导性的[Chialisp演练](https://docs.chia.net/guides/)：安装、创建智能币和使用BLS签名的指南。 +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 - Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md index b45464d324..24cb016278 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md @@ -5,17 +5,17 @@ slug: /chialisp-intro import Runnable from '@site/src/components/Runnable.tsx'; -In this lesson, we review the basics of Chialisp including syntax & structure, inequalities and if statements, and setting up a development environment. +在本课程中，我们将回顾 Chialisp 的基础知识，包括语法& 结构、不等式和 if 语句，以及设置开发环境。 -## Learning objectives +## 学习目标 -- **Syntax and Structure**: Understand the basic Chialisp syntax and structure. -- **Puzzles and Solutions**: Understand the use of puzzles and solutions in Chialisp. -- **Development Environment**: Setup and configure the Chialisp development environment. +- **语法和结构**：理解基本的 Chialisp 语法和结构。 +- **谜题和解决方案**：了解在 Chialisp 中使用谜题和解决方案。 +- **开发环境**：安装和配置 Chialisp 开发环境。 --- -## Content +## 内容
@@ -23,77 +23,77 @@ In this lesson, we review the basics of Chialisp including syntax & structure, i --- -## Script +## 脚本
- Expand for the full script + 展开查看完整脚本 00:00 -We're going to go over the very basics of Chialisp we'll talk about a few things the basic syntax and structure of a Chialisp program puzzles and solutions and set up a development environment to test it all out. +我们将简要介绍 Chialisp 的基础知识，包括：Chialisp 程序的基本语法和结构、谜题和解决方案，以及设置开发环境来测试这些内容。 00:20 -So let's get started, the first thing you'll want to do is make sure you have the correct version of python. If you type in python3-version make sure you have python 3.10. Next we're going to want to create a virtual environment so if you run the command python3 -m venv venv. +So let's get started, the first thing you'll want to do is make sure you have the correct version of python. If you type in python3-version make sure you have python 3.10. Next we're going to want to create a virtual environment so if you run the command python3 -m venv venv. 如果你输入 `python3 --version`，确保你安装的是 Python 3.10。 接下来，我们要创建一个虚拟环境，你可以运行命令 `python3 -m venv venv`。 00:40 -This is going to create a virtual environment that we can activate to do our development in and to activate it we're going to type in this command bin\activate and now you can see that we are in a virtual environment. +这将创建一个虚拟环境，我们可以激活它进行开发。要激活它，我们将输入以下命令：`bin\activate`，现在你可以看到我们已经进入了虚拟环境。 01:00 -Next we're going to want to install the Chia Dev tools and you can do this by in running pip install Chia Dev tools and let it do its thing. So now let's just make sure we have the correct version by typing cdv --version and you can see we have version 1.1.4. +接下来，我们需要安装 Chia 开发工具，你可以通过运行 `pip install Chia Dev tools` 来完成。 现在，让我们确保我们安装了正确版本，输入 `cdv --version`，你会看到我们的版本是 1.1.4。 01:20 -So now we have our development environment all set up let's go over some key lisp basics. This is the basic run command it takes a list with an operator followed by two operands. +现在我们已经设置好了开发环境，让我们来学习一些关键的 Lisp 基础知识。 这是基本的运行命令，它接受一个带有运算符后跟两个操作数的列表（list）。 01:40 -In this example, we have the operands two and three and they'll be added together so we should get five. That's not very useful though so let's create a program that we can pass in some parameters and do the addition for us. All right in this example we have defined a module that receives two parameters arg1 arg2 and then runs the operation on those two parameters so when we run this we're going to get the compiled version of the program that we just wrote. +在这个例子中，我们有两个操作数，分别是2和3，它们将被相加，所以我们应该得到5。 但这并不是很有用，所以让我们创建一个程序，可以传入一些参数，并为我们执行加法。 在这个例子中，我们定义了一个模块，接收两个参数 arg1 和 arg2，然后对这两个参数进行操作，所以当我们运行它时，我们将得到刚刚编写的程序的编译版本。 02:00 -This is called the puzzle the arguments will be passed into the puzzle as a solution. So how do we run this code? Well our second command is brun so if we pass this compiled puzzle through the brun command and give it a solution such as 7 and 10. +这被称为谜题（puzzle），参数将作为解决方案（solution）传递到谜题中。 那么我们如何运行这段代码呢？ 我们的第二个命令是 `brun`，所以如果我们通过 `brun` 命令传递这个编译后的谜题，并给它一个解决方案，比如 7 和 10。 02:20 -It's going to use that solution as the parameters for the program so we should get 17. Now let's talk about inequalities and if statements. In this program I'm comparing two numbers 10 and 5, and seeing if the first is greater than the second. So in this case the result would be true and we receive a 1. +它将使用该解决方案作为程序的参数，所以我们应该得到 17。 现在让我们谈谈不等式和 if 语句。 在这个程序中，我比较了两个数字 10 和 5，并检查第一个是否大于第二个。 因此在这种情况下，结果将为真，我们会收到一个 1。 02:40 -In the opposite case it would be false and we received an empty set so if statements are going to take this structure if followed by our comparison then the result if it's true followed by the result if it's false. So let's run this program, if 1 which is true return true, else return false. +在相反的情况下，结果将为假，并且我们会收到一个空集（empty set），so if statements are going to take this structure if followed by our comparison then the result if it's true followed by the result if it's false. 所以让我们运行这个程序，如果是1意味着结果为真，则返回true，否则返回false。 03:00 -So we expect to see true. So let's create a puzzle using comparisons and if statements. So we're going to type run and define a module that takes two arguments arg1 arg2. So we're going to define an if statement and we want to know if we add the two arguments together if they're greater than 100. +所以我们期望的结果是真（true）。 那么让我们使用比较和 if 语句创建一个谜题。 我们将输入 `run` 并定义一个接受两个参数 `arg1` 和 `arg2` 的模块（module ）。 我们将定义一个 if 语句，我们想知道如果我们将这两个参数加在一起，它们是否大于 100。 03:20 -So if greater than the addition of argument 1 and argument 2 is greater than 100 then we're going to return large if it's true and small if it's false. +所以如果大于参数 1 和参数 2 的加法结果大于 100，那么如果为真，我们将返回 "large"，如果为假，我们将返回 "small"。 03:40 -We'll close this and as you can see it's really easy to get lost in the parentheses so for future videos we'll be using a text editor which will make this a lot easier but if we run this we will receive the compiled version of our program and let's pass that puzzle into brun with our solution so run and +我们将关闭这个，正如你所看到的，很容易在括号中迷失方向，所以在未来的视频中，我们将使用文本编辑器，这将使得操作变得更加简单，但如果我们运行这个，我们将收到我们程序的编译版本，然后将这个谜题与我们的解决方案一起传递给 `brun`。 04:00 -we'll add 70 and 100 which is guaranteed to be over 100 so we should receive the result large and that's it. That's the basics of Chialisp; we've talked about basic operators, inequalities if statements compiling our program into puzzles, and passing in a solution. +我们将添加 70 和 100，这肯定会超过 100，所以我们应该收到结果 "large"，就是这样。 这就是 Chialisp 的基础知识；我们讨论了基本运算符、不等式、if 语句、将程序编译成谜题（puzzles），并传递解决方案（solution）。 04:20 -In future videos we'll talk about smart coins signatures and inner puzzles. Thanks for joining me and I'll catch you in the next video! +在未来的视频中，我们将讨论智能币、签名和内部谜题。 感谢您的参与，我们下个视频见！
--- -## Common gotchas +## 常见问题 -- **run vs brun:** Run is used to serialize and run chialisp puzzles while brun is used to run clvm serialized puzzles generally when passing arguments. -- **Parentheses:** Chialisp is part of the fully parenthesized prefix notation programming language family tracing their [origins]() to LISP 1 from the 1950s. One highly apparent aspect of these languages is their use of parenthesis to denote lists. It is recommended to use an IDE with proper syntax highlighting when writing these languages to ensure that all parenthesis are in the proper places. To help with this here is a [Chialisp language server extension](https://marketplace.visualstudio.com/items?itemName=ChiaNetwork.chialisp) for Visual Studio. -- **Prefix Notation:** Chialisp being part of the LISP family uses prefix notation. This means that the functions or operators appears first with their arguments following. +- **run vs brun:** `run` 用于序列化并运行 Chialisp 谜题，而 `brun` 用于运行 clvm 序列化的谜题，通常用于传递参数。 +- **括号（Parentheses）：**Chialisp 是完全括号前缀表示法编程语言家族的一部分，可以[追溯](https://en.wikipedia.org/wiki/Lisp_(programming_language))到上世纪 50 年代的 LISP 1。 这些语言的一个显而易见的特点是它们使用括号来表示列表（lists）。 建议在编写这些语言时使用具有适当语法高亮功能的集成开发环境，以确保所有括号都处于正确的位置。 为了帮助解决这个问题，这里有一个适用于 Visual Studio 的 [Chialisp 语言服务器扩展](https://marketplace.visualstudio.com/items?itemName=ChiaNetwork.chialisp)。 +- **前缀表示法：**Chialisp 作为 LISP 家族的一部分，使用前缀表示法。 这意味着函数或运算符首先出现，其参数紧随其后。 --- -## Knowledge check +## 知识检测 -:::tip Question 1 - Subtraction +:::tip 问题 1 - 减法 -What is a chialisp puzzle for subtracting two arguments? +请给出一个用于计算两个参数相减的Chialisp 谜题？ :::
- Answer (expand when ready to see the answer) + 答案(当准备好查看答案时展开) ```chialisp (mod (arg1 arg2) @@ -103,9 +103,9 @@ What is a chialisp puzzle for subtracting two arguments?
-:::tip Question 2 - Comparison +:::tip 问题 2 - 比较 -What is the serialized form of this chialisp puzzle? +这个 Chialisp 谜题的序列化形式是什么？ ```chialisp (mod (arg1 arg2) @@ -117,7 +117,7 @@ What is the serialized form of this chialisp puzzle?
- Answer (expand when ready to see the answer) + 答案(当准备好查看答案时展开) ```chialisp (> 2 5) @@ -125,17 +125,17 @@ What is the serialized form of this chialisp puzzle?
-:::tip Question 3 - If Statement +:::tip 问题 3 - If 语句 -What is the result of the below serialized puzzle and solution? +下面的序列化谜题和解决方案的结果是什么？ -Puzzle: +谜题： ```chialisp (a (i 2 (q 1 . "true") (q 1 . "false")) 1) ``` -Solution: +解决方案: ```chialisp (1) @@ -145,26 +145,26 @@ Solution:
- Answer (expand when ready to see the answer) + 答案(当准备好查看答案时展开) `"true"`
-:::tip Question 4 - Combining all of the above +问题 4 - 将上述所有内容结合起来 -What is a Chialisp puzzle that performs the following? +执行以下操作的 Chialisp 谜题是什么？ -- Accepts two arguments -- Adds the two arguments together -- Compares the sum of the arguments to 100 -- Results in "Large" when the sum is greater than 100 and "Small" when the sum is less than 100 +- 接受两个参数 +- 将这两个参数相加 +- 比较参数的和是否大于 100 +- 当参数的和大于 100 时结果为 "Large"，当参数的和小于 100 时结果为 "Small" :::
- Answer (expand when ready to see the answer) + 答案(当准备好查看答案时展开) ```chialisp (mod (arg1 arg2) @@ -176,13 +176,13 @@ What is a Chialisp puzzle that performs the following? --- -## Additional resources +## 附加资源 -### Runnable Chialisp and clvm plugins +### 可运行的Chialisp和clvm插件 -For information on using these plugins please refer to the [academy overview](/academy-overview#runnable-chialisp-and-clvm-plugins) +有关如何使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins) -#### Chialisp plugin +#### Chialisp 插件 @@ -194,7 +194,7 @@ For information on using these plugins please refer to the [academy overview](/a -#### Clvm plugin +#### Clvm插件 @@ -204,11 +204,11 @@ For information on using these plugins please refer to the [academy overview](/a -### Links +### 链接 -- General [chialisp concepts](https://docs.chia.net/guides/chialisp-concepts): overviews of currying, inner puzzles, and morphing conditions. -- Guided [chialisp walkthroughs](https://docs.chia.net/guides/): guides for installation, creating smart coins, and working with BLS signatures. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. -- Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. +- Chialisp[基本概念](https://chialisp.com/chialisp-concepts/)：包括柯里化（currying）、内部谜题（inner puzzles）和条件变换（morphing conditions）的概述。 +- 指导性的[Chialisp演练](https://docs.chia.net/guides/)：安装、创建智能币和使用BLS签名的指南。 +- Chialisp[详细文档](https://chialisp.com/)：关于Chialisp所有方面的详细信息 +- 从[Discord](https://discord.gg/chia)获取支持：如需进一步支持，请加入我们的Discord服务器，并在 #chialisp 或 #support 频道中提问 --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md index 45807de540..27b1510ffd 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md @@ -5,16 +5,16 @@ slug: /chialisp-signatures import Runnable from '@site/src/components/Runnable.tsx'; -In this lesson, we go over how to secure coins using signatures. +在这节课中，我们将讨论如何使用签名来保护币。 -## Learning objectives +## 学习目标 -- **Signing and Signatures**: Understand the uses and benefits of signatures. -- **Chialisp Library files**: Learn about helpful Chialisp libraries to simplify development. +- **签名（Signing、Signatures）**：了解签名的用途和好处。 +- **Chialisp 库文件**：了解简化开发的有用Chialisp库。 --- -## Content +## 内容
@@ -22,91 +22,91 @@ In this lesson, we go over how to secure coins using signatures. --- -## Script +## 脚本
Expand for the full script 00:00\ -We created our first smart coin and secured it so that only someone with the correct password could spend it. In this video, we'll use a signature to secure our coin so that only the person with the correct signature will be able to spend the coin. +我们创建了我们的第一个智能币，并将其安全地保护，只有拥有正确密码的人才能使用它。 在本视频中，我们将使用签名来保护我们的币，以便只有拥有正确签名的人才能使用这个币。 00:20\ -So what is a signature? A digital signature allows you to sign a message with a private key. This message can then be verified by a recipient using your public key. Let's start with an example of signing a message and then verifying it. +那么什么是签名？ 数字签名允许您使用私钥对消息进行签名。 然后，接收方可以使用您的公钥验证此消息。 让我们从签署消息并验证它的示例开始。 00:40\ -Run `chia keys sign --message` with the message `"hello" --hdpath m` then choose your wallet ID. This process will sign the message 'hello' with your private key. To verify this message we'll run `chia keys verify` enter the message, then the signature and the sender's public key. (`chia keys verify --message hello --signature [SIG] --public_key [PUB_KEY]`) +运行 `chia keys sign --message`，消息为 `"hello"`，`--hdpath m`，然后选择您的钱包ID。 此过程将使用您的私钥对消息 'hello' 进行签名。 要验证此消息，我们将运行 `chia keys verify`，输入消息，然后是签名和发送方的公钥。 (`chia keys verify --message hello --signature [SIG] --public_key [PUB_KEY]`) 01:00\ -So now that we know how signing works, let's create a coin that can be spent when given the correct signature. So in our chialisp file, let's define a module that takes two parameters. The first will be a public key that we'll curry in later. This will determine who is able to spend the coin. +现在我们知道签名的工作原理了，让我们创建一个只有在提供正确签名时才能花费的币。 因此，在我们的 chialisp 文件中，让我们定义一个接受两个参数的模块。 第一个将是我们稍后将添加的公钥。 这将确定谁可以花费这个币。 01:20\ -The second parameter will be the conditions that determine how the coin will be spent. Next, we'll include some libraries to make our code a bit easier to write. The first lets us use written condition codes rather than number codes, and the second is a library for tree hashing. +第二个参数将是决定如何花费币的条件。 接下来，我们将包含一些库，以使我们的代码更易于编写。 第一个库允许我们使用编写的条件代码而不是数字代码，第二个库是一个用于树哈希的库。 01:40\ -To install these libraries, run this command in the terminal. `cdv clsp retrieve sha256tree condition-codes`. Back to our chialisp file, we'll define a combine statement with`c` and for the first parameter, create a list composed of the `AGG_SIG_ME` condition, our public key parameter and the conditions parameter run through the tree hashing library. (`(c (list AGG_SIG_ME PUBLIC_KEY (sha256tree conditions)) conditions)`) +要安装这些库，在终端中运行此命令。 `cdv clsp retrieve sha256tree condition-codes`. 回到我们的 chialisp 文件，我们将使用 `c` 定义一个组合语句，对于第一个参数，创建一个由 `AGG_SIG_ME` 条件、我们的公钥参数和通过树哈希库的条件参数组成的列表。 (`(c (list AGG_SIG_ME PUBLIC_KEY (sha256tree conditions)) conditions)`) 02:00\ -The second parameter in the combine statement will be the conditions that are passed into the program. So what does this do? Well the `AGG_SIG_ME` condition is a standard condition that signs a message with a public key. In this case we are currying in the key and the message is the tree hash of the conditions parameter. +组合语句中的第二个参数将是传递到程序中的条件。 那么这是做什么的呢？ `AGG_SIG_ME` 条件是一个标准条件，用公钥签名消息。 在这种情况下，我们将在键和消息是条件参数的树哈希之后对键进行曲线处理。 02:20\ -We do this so that the conditions cannot be modified by the farmer. So in order to spend the coin, the user must provide a solution that contains a list of conditions; or how they'd like to spend the coin; as well as a signature to show that they are the ones authorized to do so. +我们这样做是为了防止农民修改条件。 因此，为了花费币，用户必须提供一个包含条件列表的解决方案；或者他们希望如何花费币的方式；以及一个签名，以表明他们是授权进行操作的人。 02:40\ -For this example, we're going to create a solution that uses the `CREATE_COIN` condition to essentially unlock the value of the coin and send it back to our wallet. First, let's finish creating this coin. We'll get our master public key with `chia keys show` and curry that into our program. It's important to prefix the key with `0x` to show that it is a value. +在本示例中，我们将创建一个解决方案，该解决方案使用 `CREATE_COIN` 条件来解锁币的价值，并将其发送回我们的钱包。 首先，让我们完成创建此币。 我们将使用 `chia keys show` 获取我们的主公钥，并将其曲线化到我们的程序中。 重要的是要用 `0x` 前缀表示它是一个值。 03:00\ -Now we'll get the puzzle reveal with `opc` and enter in the compiled code. Make sure to save this for later. And for the puzzle hash we'll run `opc -h` and enter the compiled code. We'll save this for later as well. We'll need to take the puzzle hash and encode it into an address. Run `cdv encode --prefix txch` and enter the puzzle hash. +现在我们将使用 `opc` 获取拼图展示，并输入编译代码。 记得保存这个以备将来使用。 对于拼图哈希，我们将运行 `opc -h` 并输入编译代码。 我们也会保存这个以备将来使用。 我们需要将拼图哈希编码成一个地址。 运行 `cdv encode --prefix txch` 并输入拼图哈希。 03:20\ -That gives us the puzzle address. Now we'll send an amount of chia to this address to lock it. And we'll check the status. Once confirmed, we'll be ready to spend it. +这给了我们拼图地址。 现在，我们将发送一定量的 chia 到这个地址以锁定它。 然后我们会检查状态。 一旦确认，我们就可以花费它了。 03:40\ -To spend the coin, we'll need to create a spend bundle. Take a look at this outline. this should look familiar to the spend bundle we created in the previous video. We'll need four things, the coin record, the puzzle reveal which we already calculated, the solution we want to provide, and an aggregated signature to authorize our spend. +要花费这个币，我们需要创建一个花费包。 看一下这个大纲。 这应该看起来很熟悉，就像我们在上一个视频中创建的花费包一样。 我们需要四件东西，币记录，我们已经计算过的拼图展示，我们想要提供的解决方案以及一个聚合签名来授权我们的花费。 04:00\ -To get the coin record, run `cdv rpc coinrecords --by puzzlehash` and enter the puzzle hash from earlier. Copy the coin object and paste it into the spend bundle template. Next we can enter the puzzle reveal we calculated earlier. For the solution, we're going to have to so some work. +要获取币记录，请运行 `cdv rpc coinrecords --by puzzlehash`，并输入之前的拼图哈希。 复制币对象，并将其粘贴到花费包模板中。 接下来，我们可以输入我们之前计算过的拼图展示。 对于解决方案，我们将需要做一些工作。 04:20\ -We'll use the standard condition `CREATE_COIN` to unlock the value of the coin and send it back to our wallet. To do that, we'll need our address which we can get with `chia wallet get address` and decode it to get the wallet address puzzle hash with `cdv decode` and our address. +我们将使用标准条件 `CREATE_COIN` 来解锁币的价值，并将其发送回我们的钱包。 为此，我们需要我们的地址，我们可以使用 `chia wallet get address` 获取，然后解码以获取钱包地址拼图哈希，并使用 `cdv decode` 和我们的地址。 04:40\ -To craft the solution, we'll run this command where `51` is the `CREATE_COIN` condition code, our wallet address puzzle hash, and an amount in mojo. We can enter this response into the solution of our spend bundle. +为了制作解决方案，我们将运行此命令，其中 `51` 是 `CREATE_COIN` 条件代码，我们的钱包地址拼图哈希，以及一个以 mojo 为单位的金额。 我们可以将此响应输入到我们的花费包的解决方案中。 05:00\ -Finally, the aggregated signature. Remember that the message we are signing is the tree hash of our conditions; or our solution. So first, let's generate that hash. Next we'll also need the coin ID and the genesis challenge. The genesis challenge is a standard value for each network. +最后，聚合签名。 请记住，我们正在签名的消息是我们的条件的树哈希；或我们的解决方案。 首先，让我们生成该哈希。 接下来，我们还需要币 ID 和起源挑战。 起源挑战是每个网络的标准值。 05:20\ -You can find the appropriate challenge by entering `chia show -s` and searching for 'genesis challenge'. Since we're on testnet10, our challenge is this value starting with 'AE'. For the coin ID, we actually need the parent ID, the puzzle hash, and the amount which can all be found in the coin record we copied earlier. +你可以通过输入 `chia show -s` 并搜索 'genesis challenge' 来找到适当的挑战。 对于币 ID，实际上我们需要父 ID、拼图哈希和金额，这些都可以在我们之前复制的币记录中找到。 05:40\ -To get the coin ID, we'll run `cdv inspect -id coins` enter the parent ID, the puzzle hash, and the amount. (`cdv inspect -id coins --parent-id [PARENT_ID] --puzzle-hash [PUZZLE_HASH] --amount [AMOUNT]`) The `AGG_SIG_ME` condition expects the concatenation of the conditions treehash, coin ID, and genesis challenge, so run +要获取币 ID，我们将运行 `cdv inspect -id coins`，然后输入父 ID、拼图哈希和金额。 （`cdv inspect -id coins --parent-id [PARENT_ID] --puzzle-hash [PUZZLE_HASH] --amount [AMOUNT]`）`AGG_SIG_ME` 条件期望条件树哈希、币 ID 和起源挑战的连接，因此运行 06:00\ -`concat` the conditions treehash, coin ID, and genesis challenge. Make sure to use the prefix `0x` to signify that these are values. Now let's sign this message and since we're NOT using it as a value, remember to remove the `0x` prefix this time. +`concat` 条件树哈希、币 ID 和起源挑战。 确保使用前缀 `0x` 表示这些都是值。 现在让我们对此消息进行签名，并且由于我们没有将其用作值，请记住这次删除 `0x` 前缀。 06:20\ -Now we can enter this signature into our spend bundle and push it. Run `cdv rpc pushtx spendbundle.json`. If your signature is incorrect, you'll get a failure message. Otherwise, congratulations! You've created a smart coin secured with a signature and spent it. +现在我们可以将此签名输入到我们的花费包中并进行推送。 运行 `cdv rpc pushtx spendbundle.json`。 如果您的签名不正确，您将收到一个失败消息。 否则，恭喜！ 您已经创建了一个智能币，并使用签名进行了保护。 06:40\ -So we've talked in this video about how signatures work, their importance, and how to implement them into a smart coin. Thanks so much for watching, I'll see you next time. +在本视频中，我们讨论了签名的工作原理、它们的重要性以及如何将它们实现到智能币中。 非常感谢观看，我们下次见。
--- -## Common gotchas +## 常见问题 -- **0x Prefixes:** It's important to keep track of how we are using different values and understand how Chialisp is going to handle them. A common gotcha is forgetting to append `0x` to a value, or in some cases removing it to tell the puzzle how to properly handle the parameter. -- **"Saving for Later":** At several points in this lesson, we generate results that we'll need to use elsewhere, sometimes many times. These results also do not have obivious indicators as to what they are. It's helpful to have a document to temporarily store these results for later use. +- **0x 前缀：** 重要的是要跟踪我们如何使用不同的值，并了解 Chialisp 将如何处理它们。 一个常见的小错误是忘记向值附加 `0x`，或在某些情况下将其删除以告诉拼图如何正确处理参数。 +- **“暂存以备后用”：** 在本课程的几个地方，我们生成了需要在其他地方使用的结果，有时候是多次。 这些结果也没有明显的指示符表明它们是什么。 为了以后使用，将这些结果临时保存在一个文件中是很有帮助的。 --- -## Knowledge check +## 知识检测 -:::tip Question 1 - Keys +:::tip 问题 1 - 密钥 -True or False. You need to use someone's private key to lock up a coin for them to spend. +正确还是错误。 你需要使用某人的私钥来锁定一枚硬币，以便他们能够花费。 ::: @@ -114,13 +114,13 @@ True or False. You need to use someone's private key to lock up a coin for them Answer (expand when ready to see the answer) -False. You would use their public key. Private keys are to be kept secret and never revealed to anyone. +错误 你应该使用他们的公钥。 私钥应保密，永远不应透露给任何人。
-:::tip Question 2 - Aggregate Signature +:::tip 问题 2 - 聚合签名 -An Aggregated Signature is comprised of which three components? +聚合签名由哪三个部分组成？ ::: @@ -128,23 +128,23 @@ An Aggregated Signature is comprised of which three components? Answer (expand when ready to see the answer) -The `AGG_SIG_ME` condition expects a concatenated value of the following: +`AGG_SIG_ME`条件期望以下值的串联： -1. The conditions treehash. -2. The coin ID. -3. The genesis challenge. +1. 条件的树哈希。 +2. 币的ID。 +3. 创世挑战。
--- -## Additional resources +## 附加资源 -### Runnable Chialisp and clvm plugins +### 可运行的Chialisp和clvm插件 -For information on using these plugins please refer to the [academy overview](/academy-overview#runnable-chialisp-and-clvm-plugins) +有关使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins)。 -#### Chialisp plugin +#### Chialisp 插件 @@ -156,7 +156,7 @@ For information on using these plugins please refer to the [academy overview](/a -#### Clvm plugin +#### Clvm插件 @@ -166,11 +166,11 @@ For information on using these plugins please refer to the [academy overview](/a -### Links +### 链接 -- General [chialisp concepts](https://docs.chia.net/guides/chialisp-concepts): overviews of currying, inner puzzles, and morphing conditions. -- Guided [chialisp walkthroughs](https://docs.chia.net/guides/): guides for installation, creating smart coins, and working with BLS signatures. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. +- [Chialisp基本概念](https://docs.chia.net/guides/chialisp-concepts)：包括柯里化（currying）、内部谜题（inner puzzles）和条件变换（morphing conditions）的概述。 +- 指导性的[Chialisp演练](https://docs.chia.net/guides/)：安装、创建智能币和使用BLS签名的指南。 +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 - Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md index 9241966bf7..1e7f8704d9 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md @@ -5,17 +5,17 @@ slug: /chialisp-smart-coin import Runnable from '@site/src/components/Runnable.tsx'; -In this lesson, we go over currying, hashing, and conditions, and submit and use our first Chia Smart Coin. +在本课程中，我们将讨论柯里化、哈希和条件，并提交并使用我们的第一个 Chia 智能硬币。 -## Learning objectives +## 学习目标 -- **Currying**: Understand how to create more general use puzzle by using Currying. -- **Hashing**: Understand the need to obfuscate sensitive portions of a puzzle by using Hashing. -- **Conditions**: Using conditions to allow the spender of the coin to decide how it is spent. +- **Currying（柯里化）**：了解如何通过柯里化创建更通用的谜题。 +- **Hashing（哈希）**：了解通过哈希来混淆谜题中的敏感部分的必要性。 +- **Conditions（条件）**：使用条件允许花费者决定如何花费币。 --- -## Content +## 内容
@@ -23,95 +23,95 @@ In this lesson, we go over currying, hashing, and conditions, and submit and use --- -## Script +## 脚本
Expand for the full script 00:00\ -Everything on a blockchain is a coin. They are often referred to as smart coins because every coin has a chialisp program associated with it. That program, known as the puzzle, decides how and when the coin can be spent, and what happens when it is. +在区块链上，一切都是一个币。 它们通常被称为智能硬币，因为每个币都与一个称为谜题的Chialisp程序相关联。 该程序决定了币何时以及如何被使用，以及在使用时会发生什么。 00:20\ -NFTs, CATs, and standard transactions are all defined using puzzles. In the previous video, we learned how to write basic chialisp programs. Let's apply that to some more complex puzzles and create a coin that can be spent on the blockchain. +NFT、CAT 和标准交易都使用谜题来定义。 在上一个视频中，我们学习了如何编写基本的Chialisp程序。 让我们将这些应用到一些更复杂的谜题中，并创建一个可以在区块链上使用的币。 00:40\ -In this video, we'll be talking about currying, hashing, and conditions. So let's get started! We'll start by creating a new chialisp file called `password.clsp` and create a module that takes a parameter `password` and determines if the value passed in equals `hello`. If it does, return correct, if not return incorrect. +在这个视频中，我们将讨论柯里化、哈希和条件。 那么让我们开始吧！ 我们将首先创建一个名为 `password.clsp` 的新Chialisp文件，并创建一个模块，它接受一个参数 `password` 并确定传入的值是否等于 `hello`。 如果是，则返回 "correct"，否则返回 "incorrect"。 01:00\ -We'll run this using the `brun` command in our terminal and pass in `hello` which should give us a success. Just to test the opposite, we'll pass in something else, and see if that fails. So this is a bit of a refresher on chialisp basics. One of the issues we have with a puzzle like this is that the hard-coded value for the password is both insecure and not very useful. +我们将在终端中使用 `brun` 命令运行这个，并传入 `hello`，这应该会给我们一个成功。 为了测试相反的情况，我们将传入其他内容，然后看看是否失败。 这是对Chialisp基础知识的一点复习。 我们这个谜题的一个问题是，密码的硬编码值既不安全也不太有用。 01:20\ -We'd like to have a generalized puzzle that we can use for any password we choose to have. For this we'll use currying and hashing. To make this puzzle more generalized, we will be using currying. To do so, let's replace our password parameter with two new ones, `CORRECT_PASSWORD` and `provided_password`, and then run our comparison on those parameters. +我们想要一个更通用的谜题，可以用于任何我们选择的密码。 为此，我们将使用柯里化和哈希。 为了使这个谜题更通用，我们将使用柯里化。 为此，让我们用两个新的参数替换我们的密码参数，`CORRECT_PASSWORD` 和 `provided_password`，然后在这些参数上运行我们的比较。 01:40\ -Now in our terminal, we can curry in a value to replace the correct password parameter and compile it. Run `cdv clsp curry password.clsp -a` and pass in our desired password, in this case - `hello` and we get the following result. Now if we run that through `brun` and give it the correct password, we should get a success. +现在在我们的终端中，我们可以柯里化一个值来替换正确的密码参数并进行编译。 运行 `cdv clsp curry password.clsp -a`，并传入我们想要的密码，这里是 `hello`，我们会得到以下结果。 现在如果我们通过 `brun` 运行它，并给它正确的密码，我们应该会得到一个成功。 02:00\ -We can also nest these commands like this - (`brun "$(cdv clsp curry password.clsp -a 'goodbye')" "(goodbye)"`). The first steps to making our puzzle more secure is to use hashing. A hash function will take an input and return a hash value. One of the most popular hashing algorithms is sha256 which is directly supported within chialisp. +我们也可以像这样嵌套这些命令 - (`brun "$(cdv clsp curry password.clsp -a 'goodbye')" "(goodbye)"`)。 使我们的谜题更安全的第一步是使用哈希。 A hash function will take an input and return a hash value. 最流行的哈希算法之一是 sha256，它直接在chialisp中支持。 02:20\ -A few important notes about hash functions; given a value, calculating the hash is extremely easy. Given a hash, calculating the original input is extremely difficult or impossible, and passing the same value through a hashing function multiple times will always result in the same output. +关于哈希函数的几个重要说明：给定一个值，计算哈希非常容易。 给定一个哈希，计算原始输入非常困难或不可能，并且通过哈希函数多次传递相同的值将始终产生相同的输出。 02:40\ -We can use these principles to our advantage by currying a hash of the expected password instead of the password value itself. This prevents us from revealing the expected password while still allowing us to check if the provided password is correct. This is done by hashing the provided password. So let's change our puzzle to use hashing. +我们可以利用这些原则，通过柯里化预期密码的哈希值而不是密码值本身来提高安全性。 This prevents us from revealing the expected password while still allowing us to check if the provided password is correct. This is done by hashing the provided password. 所以让我们改变我们的谜题来使用哈希。 03:00\ -First, change the curried parameter to `PASSWORD_HASH` and change the other parameter to `password`. In the comparison, use sha256 to hash the given password and compare it to the password hash. To test this we'll first have to hash a password and curry it into our new puzzle. +首先，将柯里化参数更改为 `PASSWORD_HASH`，并将其他参数更改为 `password`。 在比较中，使用 sha256 来哈希给定的密码，并将其与密码哈希进行比较。 为了测试这个，我们首先需要对密码进行哈希并将其柯里化到我们的新谜题中。 03:20\ -Run `cdv hash "hello"` to get the hash for the password 'hello'. We can now curry this into our puzzle like last time, making sure to prefix the hash with `0x` to identify it as a chialisp value. Now we can pass this compiled puzzle through `brun` and provide the correct password to test. +运行 `cdv hash "hello"` 来获取密码 "hello" 的哈希。 现在我们可以像上次一样将其柯里化到我们的谜题中，确保用 `0x` 前缀标识为chialisp值。 现在我们可以通过 `brun` 传递这个编译后的谜题，并提供正确的密码进行测试。 03:40\ -It's important to know that while hashing is an essential part of securing our puzzle, this is not quite enough. When we provide our solution with the correct password, that password will be visible on the blockchain. Meaning we won't be able to use it again. The final solution to this problem is to use signatures, which we'll talk about in a future video. Now that we've talked about currying and hashing, let's talk about conditions. +重要的是要知道，虽然哈希是确保我们的谜题安全的重要部分，但这还不够。 当我们用正确的密码提供我们的解决方案时，该密码将在区块链上可见。 这意味着我们将无法再次使用它。 解决这个问题的最终方法是使用签名，我们将在未来的视频中讨论。 现在我们已经讨论了柯里化和哈希，让我们谈谈条件。 04:00\ -In our password puzzle, let's make a couple of additions. First, we'll add a parameter called conditions and then replace the success and fail messages with that parameter, followed by `(x)`. So what does this do? Well the `x` represents an error. If the password is incorrect, the if statement will evaluate to false and error out, terminating the program and leaving the coin that we are creating unspent. +在我们的密码谜题中，让我们做一些添加。 首先，我们将添加一个名为 `conditions` 的参数，然后用该参数替换成功和失败消息，后跟 `(x)`。 那么这是做什么的呢？ 好吧，`x` 代表错误。 如果密码不正确，if 语句将计算为 false，并且出错，终止程序，并使我们创建的币未花费。 04:20\ -If the correct password is given, the conditions that are provided by the spender will be run. So back to our terminal, first we'll need to curry in our hashed password as before. Now that we have the compiled puzzle, we're going to need to do a few things to create the coin. First, we'll need the puzzle hash which we can get by running `opc -H` and passing in our compiled puzzle. +如果给出正确的密码，则conditions 提供者提供的条件将会执行。 回到我们的终端，首先我们需要像之前一样柯里化我们的哈希密码。 现在我们有了编译后的谜题，我们需要做一些事情来创建币。 首先，我们需要谜题哈希，我们可以通过运行 `opc -H` 并传入我们的编译后的谜题来获得。 04:40\ -We'll save the result for later. Next, we'll need the puzzle reveal which is just a serialized form of the puzzle in hex. It's what you must reveal on chain when spending a coin. We can get this by running `opc` and passing in our compiled puzzle. We'll save this for later as well. +我们将保存结果供以后使用。 接下来，我们需要谜题揭示，它只是谜题的十六进制序列化形式。 这是在花费币时必须在链上揭示的内容。 我们可以通过运行 `opc` 并传入我们的编译后的谜题来获得这个。 我们也会保存这个以备将来使用。 05:00\ -Now to create the coin, we need to encode our puzzle hash into an address with `cdv encode -p txch` and passing in our puzzle hash. We then send that address an amount of xch to lock it. Now let's spend the coin to release value back to our wallet. First, we'll get our wallet address and convert it to a puzzle hash with `cdv decode`. +现在要创建币，我们需要将我们的谜题哈希编码为一个地址，使用 `cdv encode -p txch` 并传入我们的谜题哈希。 然后我们将给该地址发送一定数量的 xch 以锁定它。 现在让我们花费币以释放价值回到我们的钱包。 首先，我们将获取我们的钱包地址，并使用 `cdv decode` 将其转换为谜题哈希。 05:20\ -We'll then use this to build the condition we want to pass into the coin. For this example, we're going to use the `CREATE_COIN` condition which is denoted by the code `51`. So to construct our solution, we'll write `opc` then give our password, then the condition we want to pass in. +接下来，我们将使用这个来构建我们要传递到币中的条件。 对于本例，我们将使用代号为 `51` 的 `CREATE_COIN` 条件。 因此，为了构建我们的解决方案，我们将写 `opc` 然后给出我们的密码，然后是我们要传递的条件。 05:40\ -In this case, the condition code `51`, our wallet puzzle hash - prefixed by `0x`, and an amount. This output is our solution and we'll save it for later. All right, we now need to retrieve the coin record we created earlier when we committed xch to the puzzle. Run `cdv rpc coinrecords --by puzzlehash` and pass in the original puzzle hash. +在这种情况下，条件代码 `51`，我们的钱包谜题哈希 - 前缀为 `0x`，以及一个数量。 这个输出就是我们的解决方案，我们会将其保存供以后使用。 好的，现在我们需要检索我们之前创建的币记录，当我们将 xch 承诺给谜题时。 运行 `cdv rpc coinrecords --by puzzlehash` 并传入原始谜题哈希。 06:00\ -The output may contain a few coin records depending on if you're following the example closely and use the most recent one based on highest block index, and copy the coin record. Now we are going to create a spend bundle. Start a `json` file and create a property called `coin_spends` that contains an array containing an object. (`[{}]`) +输出可能会包含一些币记录，具体取决于您是否紧密遵循示例，并根据最高区块索引选择最近的一个，并复制币记录。 现在我们将创建一个花费捆绑包。 开始一个 `json` 文件，并创建一个名为 `coin_spends` 的属性，其中包含一个包含一个对象的数组。 (`[{}]`) 06:20\ -Paste the coin record, followed by the puzzle reveal you generated earlier, and then the solution. Create another property called `aggregated_signature` and assign this value (`0xc0000000000...`) That's 191 zeros. Now submit the spend bundle to the mempool with `cdv rpc pushtx spendbundle.json`. +粘贴币记录，然后是您之前生成的谜题揭示，然后是解决方案。 创建另一个名为 `aggregated_signature` 的属性，并将其分配为这个值（`0xc0000000000...`）这是 191 个零。 现在将花费捆绑包提交到内存池中，使用 `cdv rpc pushtx spendbundle.json`。 06:40\ -If everything was successful, this transaction should be accepted and you should see your wallet balance increase after some time passes. Now you've created your first smart coin. In this video, we talked about how to curry values into a generalized puzzle, how to hash both sensitive values as well as puzzles for creating coins, and touched on conditions that can be passed into puzzles. +如果一切顺利，此交易应该被接受，一段时间后您应该会看到您的钱包余额增加。 现在您已经创建了您的第一个智能币。 在本视频中，我们讨论了如何将值柯里化到通用谜题中，如何对敏感值以及用于创建币的谜题进行哈希，并简要介绍了可以传递到谜题中的条件。 07:00\ -In the next video, we'll talk further about security and how to use signatures to better secure your transactions. See you then. +在下一个视频中，我们将进一步讨论安全性以及如何使用签名来更好地保护您的交易。 那时再见。
--- -## Common gotchas +## 常见问题 -- **Curried parameters:** It's considered best practice to write parameters that are intended to be curried in in all caps. This helps keep track of where each parameter is coming from while writing the puzzle. -- **0x Prefixes:** It's important to keep track of how we are using different values and understand how Chialisp is going to handle them. A common gotcha is forgetting to append `0x` to a value, or in some cases removing it to tell the puzzle how to properly handle the parameter. -- **Condition Codes:** Condition codes are by default signified by a numerical code. In future lessons, we will also use a library that allows us to reference the codes with more descriptive language. +- **柯里化参数：** 最佳实践是将意图进行柯里化的参数写成大写字母。 这有助于在编写谜题时跟踪每个参数的来源。 +- **0x 前缀：** 重要的是要跟踪我们如何使用不同的值，并了解 Chialisp 将如何处理它们。 一个常见的小错误是忘记向值附加 `0x`，或在某些情况下将其删除以告诉拼图如何正确处理参数。 +- **条件代码：** 条件代码默认用数字代码表示。 在未来的课程中，我们还将使用一个允许我们使用更具描述性语言引用代码的库。 --- -## Knowledge check +## 知识检测 -:::tip Question 1 - Curried Parameters +:::tip 问题 1 - 柯里化参数 -Which parameter in this puzzle will be curried in? +在这个谜题中，哪个参数将被柯里化进去？ ```chialisp (mod (ARG1 arg2) @@ -128,15 +128,15 @@ Which parameter in this puzzle will be curried in? Answer (expand when ready to see the answer) -ARG1 will be curried in. +ARG1 将被柯里化进去。 -Currying always substitutes parameters in order, so when currying, the first will be replaced. Best practice is to write a curried parameter in all caps to help us keep track. +柯里化始终按顺序替换参数，因此在柯里化时，第一个将被替换。 最佳实践是将柯里化的参数用大写字母写出，以帮助我们跟踪。
-:::tip Question 2 - Hashing Principles +:::tip 问题 2 - 哈希原理 -What are the three principles of hashing? +哈希的三个原理是什么？ ::: @@ -144,15 +144,15 @@ What are the three principles of hashing? Answer (expand when ready to see the answer) -1. Given a value, hashing that value is computationally easy -2. Given a hash, calculating the value is computationally difficult or impossible -3. Hashing the same input, will result in the same output +1. 给定一个值，对该值进行哈希是计算上容易的。 +2. 给定一个哈希，计算出原始值是计算上困难或不可能的。 +3. 对相同的输入进行哈希，将会得到相同的输出。
-:::tip Question 3 - Hashing Puzzle +:::tip 问题 3 - 哈希谜题 -True or False. Sha256 is one of the most popular hashing algorithms and is natively supported by chialisp. +正确还是错误。 Sha256是最流行的哈希算法之一，并且在chialisp 中得到了原生支持。 ::: @@ -164,13 +164,13 @@ True -:::tip Question 4 - Combining all of the above +:::tip 问题 4 - 结合上述所有内容 -Write a Chialisp puzzle that performs the following. +编写一个 Chialisp 谜题，执行以下操作。 -- Accepts a curried parameter -- Hashes a provided parameter with sha256 and compares it to the curried parameter. -- Outputs a provided result if the comparison is true. +- 接受一个柯里化参数 +- 使用sha256哈希提供的参数，并将其与柯里化参数进行比较。 +- 如果比较结果为真，则输出提供的结果。 ::: @@ -191,13 +191,13 @@ Write a Chialisp puzzle that performs the following. --- -## Additional resources +## 附加资源 -### Runnable Chialisp and clvm plugins +### 可运行的Chialisp和clvm插件 -For information on using these plugins please refer to the [academy overview](/academy-overview#runnable-chialisp-and-clvm-plugins) +有关使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins)。 -#### Chialisp plugin +#### Chialisp 插件 @@ -209,7 +209,7 @@ For information on using these plugins please refer to the [academy overview](/a -#### Clvm plugin +#### Clvm插件 @@ -219,11 +219,11 @@ For information on using these plugins please refer to the [academy overview](/a -### Links +### 链接 -- General [chialisp concepts](https://docs.chia.net/guides/chialisp-concepts): overviews of currying, inner puzzles, and morphing conditions. -- Guided [chialisp walkthroughs](https://docs.chia.net/guides/): guides for installation, creating smart coins, and working with BLS signatures. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. +- [Chialisp基本概念](https://docs.chia.net/guides/chialisp-concepts)：包括柯里化（currying）、内部谜题（inner puzzles）和条件变换（morphing conditions）的概述。 +- 指导性的[Chialisp演练](https://docs.chia.net/guides/)：安装、创建智能币和使用BLS签名的指南。 +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 - Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/challenges-plot-filters.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/challenges-plot-filters.md index c0c8c742fd..23441312cc 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/challenges-plot-filters.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/challenges-plot-filters.md @@ -1,18 +1,18 @@ --- -title: Challenges & Plot Filters +title: 挑战和图块初筛 slug: /challenges-plot-filters --- -In this lesson, we discuss how the plot filter works, and what the benefits are of using one. +在本课中，我们将讨论图块初筛的工作原理，以及使用它的好处。 -## Learning objectives +## 学习目标 -- **Plot Filters**: Understand the basics of how the plot filter works, as well as the benefits of using one. -- **Challenge Generation**: Understand how the challenge is generated by the Timelord and sent to the Farmer. +- **图块初筛**：了解图块初筛的基本工作原理及其使用的好处。 +- **挑战生成**：了解时间领主（Timelord）如何生成挑战并将其发送给农民。 --- -## Content +## 内容
@@ -20,39 +20,39 @@ In this lesson, we discuss how the plot filter works, and what the benefits are --- -## Script +## 脚本
Expand for the full script 0:00\ -The Timelord generates a new challenge about every 9 seconds. This is then hashed with the ID of each plot. +时间领主大约每9秒生成一个新挑战。 然后将其与每个图块的ID进行哈希处理。 0:20\ -If the hash starts with 9 zeroes, the plot is considered eligible for harvesting. This is called the plot filter. The Plot Filter serves as a decentralizing force to further randomize the winner, as well as reduce the total compute needed for each challenge. +如果哈希值以9个零开头，该图块被认为有资格进行收割。 这称为图块初筛。 图块初筛作为去中心化的力量，进一步随机化赢得区块的农民，并减少每个挑战所需的总计算量。 0:40\ -When a farmer receives a challenge, the harvester first determines which plots are valid and pass the plot filter, then produces potential proofs of space and submits them to the Timelord for verification and review. +当农民收到挑战时，收割者首先确定哪些图块是有效的并通过图块初筛，然后生成潜在的空间证明并提交给时间领主进行验证和审查。 1:00\ -The Timelord will choose the Proof of Space that most closely meets the challenge, and using the challenge and provided Proof of Space as inputs, runs a VDF to prove that time has passed and produces the next challenge. +时间领主将选择最符合挑战的空间证明，并使用挑战和提供的空间证明作为输入，运行一个VDF来证明时间已经过去，并生成下一个挑战。
--- -## Common gotchas +## 常见问题 -- **Are valid proofs filtered out?:** It is very possible that a valid proof of space would be contained in a filtered plot. This affects every farmer equally though, and the benefits of further decentralization are well worth it. +- **有效证明会被过滤掉吗？**：一个有效的空间证明很可能会包含在被过滤掉的图块中。 然而，这对每个农民的影响是平等的，并且进一步去中心化的好处是非常值得的。 --- -## Knowledge check +## 知识检测 -:::tip Question 1 - Challenge Frequency +:::tip 问题1 - 挑战频率 -About how often will a Timelord generate a new challenge? +时间领主大约每隔多久生成一个新的挑战？ ::: @@ -60,13 +60,13 @@ About how often will a Timelord generate a new challenge? Answer (expand when ready to see the answer) -`"About every 9 seconds"` +大约每9秒钟 -:::tip Question 2 - Filter Benefits +:::tip 问题2 - 初筛的好处 -What are the two significant benefits of using a plot filter? +使用图块初筛的两个重要好处是什么？ ::: @@ -74,22 +74,20 @@ What are the two significant benefits of using a plot filter? Answer (expand when ready to see the answer) -```bash -1. It further decentralizes the network. -2. It reduces the amount of compute needed, improving network efficiency -``` +1. 进一步去中心化了网络。 +2. 它减少了所需的计算量，提高了网络的效率。 --- -## Additional resources +## 附加资源 -### Links +### 链接 -- More [farming basics](https://docs.chia.net/farming-basics): overviews of plotting, pooling, and rewards. -- In depth [architecture overview](https://docs.chia.net/architecture-overview): describing the interactions between Farmers, Harvesters, Wallets, etc. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. +- 更多的[耕种基础知识](https://docs.chia.net/farming-basics)：绘图、矿池和奖励的概述。 +- 详细的[架构概述](https://docs.chia.net/architecture-overview)：描述农民、收割机、钱包等之间的交互。 +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 - Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/farming-overview.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/farming-overview.md index 34bbbde9af..47326d025c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/farming-overview.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/farming-overview.md @@ -1,18 +1,18 @@ --- -title: Farming Overview +title: 耕种概览 slug: /farming-overview --- -In this lesson, we go over the plotting process, and what happens when a Farmer wins a challenge. +在本课程中，我们将介绍绘图过程，以及当农名赢得挑战时会发生什么。 -## Learning objectives +## 学习目标 -- **Protocols**: Understand the basics of the Chia Farming protocol. -- **Puzzles and Solutions**: Understand the use of puzzles and solutions in Chialisp. +- **协议**：了解Chia耕种协议的基础知识。 +- **谜题（Puzzles）和解决方案（Solutions）**：了解谜题和解决方案在Chialisp中的使用。 --- -## Content +## 内容
@@ -20,43 +20,43 @@ In this lesson, we go over the plotting process, and what happens when a Farmer --- -## Script +## 脚本
Expand for the full script 0:00\ -Farmers are nodes that seek to win Proof of Space challenges in exchange for rewards. The Farmer that wins a challenge constructs and processes a block of transactions and adds it to the blockchain. +农民（Farmers）是寻求赢得空间证明挑战以换取奖励的节点。 赢得挑战的农民会构建并处理一个交易区块，并将其添加到区块链中。 0:20\ -To start, the Farmers pre-generate hashes into large blocks called Plots. The size of these plots are determined by a constant, k. k32 is the minimum required size and equates to around 108GB per plot. +首先，农民预先生成哈希值到称为图块（Plots）的大块（large blocks）中。 这些图块的大小由一个常数k决定，k32是所需的最小尺寸，相当于每个图块约108GB。 0:40\ -This plotting process is computationally intensive, similar to classic blockchain "mining", however, this process is only done once, reducing the overall energy usage immensely. Once the plots are created, they are then passively monitored by harvesters to determine if they contain a valid Proof of Space for the current network challenge. +这个绘图过程计算密集，类似于传统区块链的“挖矿”，但这个过程只需要进行一次，大大减少了整体能耗。 一旦图块创建完成，它们会被农民被动监控，以确定它们是否包含当前网络挑战的有效空间证明。 1:00\ -If the Farmer wins the challenge, they will start filling a block with transactions from the mempool. The Farming client has control of which transactions to include in the block, and will usually choose based on the largest Farming Fee, adding to the overall reward received. +如果农民赢得了挑战，他们将开始从内存池中填充交易到区块中。 耕种客户端将控制哪些交易可以包含到区块中，通常会根据最高的耕种手续费用来做选择，从而增加总奖励。 1:20\ -The block is then processed, meaning all the transactions and programs within smart coins are executed and resolved. The block is then signed by the farmer and submitted to the chain. +然后处理该区块，意味着所有交易和智能币中的程序都会被执行和解决。 区块随后由农民签名并提交到链上。
--- -## Common gotchas +## 常见问题 -- **Continuous Harvesting:** Plots do not need to be continuously created. A Farmer can create many plots all at once, and continuously harvest from those plots well into the future. The plots will remain valid and in use even after a proof of space has been found. -- **Choosing Transactions:** Transactions are stored temporarily in the "mempool" and are retrieved by a winning Farmer to create a block. The transactions can be chosen to maximize the reward a Farmer receives by prioritizing the transactions that include Farming Fees. This means that if a transaction doesn't include a Fee, there is a chance that it will not be included in a block even if it was created before the transactions that were. +- **持续收获**：图块不需要一直创建。 农民可以一次性创建许多图块，并在未来持续从这些图块中收获。 即使在找到空间证明之后，这些图块仍然有效并且可以使用。 +- **选择交易**：交易暂时存储在“内存池”中，获胜的农夫会从其中检索交易来创建区块。 可以通过优先选择包含耕种手续费的交易来最大化农民获得的奖励。 这意味着如果一笔交易没有包含手续费，即使它在其他包含手续费的交易之前创建，也有可能不会被包含在区块中。 --- -## Knowledge check +## 知识检测 -:::tip Question 1 - k Size +:::tip 问题1 - k值 -What is the minimum k size required by the Chia blockchain? +Chia区块链要求的最小k值是多少？ ::: @@ -64,13 +64,13 @@ What is the minimum k size required by the Chia blockchain? Answer (expand when ready to see the answer) -`"k32"` +k32 -:::tip Question 2 - Plot File Size +:::tip 问题2 - 图块文件大小 -How large is a plot file when using the minimum k-size, k32? +使用最小k值k32时，图块文件有多大？ ::: @@ -78,13 +78,13 @@ How large is a plot file when using the minimum k-size, k32? Answer (expand when ready to see the answer) -`"Around 108GB"` +大约108GB -:::tip Question 3 - Plotting Frequency +:::tip 问题3 - 绘图频率 -How often should a Farmer replot? +农民应该多长时间重新绘图一次？ ::: @@ -92,13 +92,13 @@ How often should a Farmer replot? Answer (expand when ready to see the answer) -`"Ideally, a Farmer should not have to replot. There may be some instances a Farmer may want to replot (alter the k-size or compression, changing from pool-based farming to solo-farming etc.), but the plots should remain valid and useful well into the future."` +理想情况下，农民不需要重新绘图。 农民可能在某些情况下会想要重新绘图(如改变k值或压缩率，从基于矿池的耕种改为独立耕种等)，但图块应长期保持有效和有用。 -:::tip Question 4 - Processing Smart Coins. +:::tip 问题4 - 处理智能币。 -True or False; When a block is created, the Timelord processes and evaluates all the contained smart coins. +真还是假；当一个区块被创建时，时间领主会处理和评估所有包含的智能币。 ::: @@ -106,19 +106,19 @@ True or False; When a block is created, the Timelord processes and evaluates all Answer (expand when ready to see the answer) -`"False. The Farmer processes the smart coins contained in the block. The Timelord infuses the block to the rest of the chain."` +错误 农民处理区块中包含的智能币。 时间领主将区块注入到链的其余部分。 --- -## Additional resources +## 附加资源 -### Links +### 链接 -- More [farming basics](https://docs.chia.net/farming-basics): overviews of plotting, pooling, and rewards. -- In depth [architecture overview](https://docs.chia.net/architecture-overview): describing the interactions between Farmers, Harvesters, Wallets, etc. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. +- 更多的[耕种基础知识](https://docs.chia.net/farming-basics)：绘图、矿池和奖励的概述。 +- 详细的[架构概述](https://docs.chia.net/architecture-overview)：描述农民、收割机、钱包等之间的交互。 +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 - Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/first-plot.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/first-plot.md index b3d8ccc8a4..9ef5901ece 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/first-plot.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/first-plot.md @@ -1,18 +1,18 @@ --- -title: Creating your first Plot +title: 创建第一个图块 slug: /first-plot --- -In this lesson, we learn how to set up the Chia client, sync our full node using a torrent file, and create our first plot to start farming. +在这节课中，我们将学习如何设置Chia客户端，使用种子文件同步我们的全节点，并创建第一个图块来开始耕种。 -## Learning objectives +## 学习目标 -- **Syncing a Full Node**: Learn how to set up the Chia client and sync a full node. -- **Plot Creation**: Learn how to create a plot. +- **同步全节点**：学习如何设置Chia客户端并同步全节点。 +- **图块创建**：学习如何创建一个图块。 --- -## Content +## 内容
@@ -20,25 +20,25 @@ In this lesson, we learn how to set up the Chia client, sync our full node using --- -## Common gotchas +## 常见问题 -- **Joining a pool before plotting:** It might seem strange to join a pool before setting up your plots, but the plots need to be generated using a plotnft in order for the pool to know who runs them. You must associate a plotnft with a pool if you want to use pooling, and if set up correctly you can always leave the pool later and farm your plots solo. +- **在创建图块之前加入矿池：** 在设置绘图之前加入矿池可能看起来有些奇怪，但图块需要使用农田（plot NFT）生成，以便矿池知道谁拥有它们。 如果你想使用矿池，你必须将农田与一个矿池关联起来，如果设置正确，你随时可以离开矿池，自己耕种你的图块。 --- -## Knowledge check +## 知识检测 -Follow along with the video, and start plotting! +跟随视频操作，开始创建图块吧！ --- -## Additional resources +## 附加资源 -### Links +### 链接 -- More [farming basics](https://docs.chia.net/farming-basics): overviews of plotting, pooling, and rewards. -- In depth [architecture overview](https://docs.chia.net/architecture-overview): describing the interactions between Farmers, Harvesters, Wallets, etc. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. +- 更多的[耕种基础知识](https://docs.chia.net/farming-basics)：绘图、矿池和奖励的概述。 +- 详细的[架构概述](https://docs.chia.net/architecture-overview)：描述农民、收割机、钱包等之间的交互。 +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 - Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/pools.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/pools.md index 9c4d53fe83..c082554f1f 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/pools.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/plotting-farming/pools.md @@ -3,16 +3,16 @@ title: Pools slug: /pools --- -In this lesson, we review the Pooling protocol, and how it can benefit a Farmer starting out. +在本课程中，我们将回顾矿池协议，以及它如何有助于刚开始的农民。 -## Learning objectives +## 学习目标 -- **Benefits of Pooling**: Understand the benefits of participating in a Pool. -- **Reward Splitting**: Understand how the rewards are split among pool participants. +- **矿池的好处**：理解参与矿池（Pool）的好处。 +- **奖励分配**：理解奖励如何在矿池参与者之间分配。 --- -## Content +## 内容
@@ -20,39 +20,39 @@ In this lesson, we review the Pooling protocol, and how it can benefit a Farmer --- -## Script +## 脚本
Expand for the full script 0:00\ -Pools are a great way to get started with Farming. Pooling allows farmers to smooth out their rewards by earning based on proof of space partials, as opposed to winning blocks. +矿池是开始耕种的一个很好的方式。 通过参与矿池，农民可以通过基于空间证明的部分证明来平滑他们的奖励，而不是通过赢得区块来获取奖励。 0:20\ -A Proof of Space partial contains some additional metadata about the farmer that lets the Pool distribute shared rewards based on relative farm size. The more valid partials a farmer generates, the larger their share of the reward. When a submitted proof of space wins, the farmer that generated it still retains the right to farm the block, and processes it themselves. +一个空间证明的部分（Proof of Space partial ）包含一些关于农民的额外元数据，这使得矿池可以根据相对农场规模分配共享奖励。 农民生成的有效部分越多，他们获得的奖励份额就越大。 当提交的空间证明获胜时，生成它的农民仍保留生成该区块的权利，并自行处理它。 0:40\ -In return, they receive 1/8 the value of the reward, while the remaining 7/8 is distributed to the rest of the pool, based on valid partials. Because the block is still farmed by an individual farmer, the network remains sufficiently decentralized. +作为回报，他们获得奖励价值的1/8，剩余的7/8根据有效部分分配给矿池的其他成员。 因为区块仍由农民生成，所以网络保持足够的去中心化。 1:00\ -The overall reward earned is largely the same over time for average sized farms, so Pooling is a great choice to get started. +随着时间的推移，对于农民来说，总体获得的奖励基本相同，因此参与矿池是一个很好的选择。
--- -## Common gotchas +## 常见问题 -- **Farming size still matters:** The size of a Farm directly relates to how many valid partials are generated, and partials determine a farmers share of the pool reward (7/8). This means there is still a benefit to large farms joining a pool. +- **农场规模仍然重要：** 农场的规模直接影响生成的有效部分数量，而有效部分决定了农民在矿池奖励中的份额(7/8)。 这意味着大型农场加入矿池仍然具有好处。 --- -## Knowledge check +## 知识检测 -:::tip Question 1 - Reward Split +:::tip 问题1 - 奖励分配 -What is the reward split between the Farmer and the Pool? +农民和矿池之间的奖励分配是多少？ ::: @@ -60,13 +60,13 @@ What is the reward split between the Farmer and the Pool? Answer (expand when ready to see the answer) -`"1/8 goes to the Farmer who won the challenge, 7/8 goes to the pool to be distributed"` +1/8的奖励给赢得挑战的农民，7/8的奖励给矿池分配 -:::tip Question 2 - Decentralized Pooling +:::tip 问题2 - 去中心化矿池 -How does the protocol maintain decentralization? +这个协议如何保持去中心化？ ::: @@ -74,19 +74,19 @@ How does the protocol maintain decentralization? Answer (expand when ready to see the answer) -`"By letting the Farmers process and author blocks, the network remains decentralized. Since the pool has no way of knowing which Farmer will win, and does not have a say on which transactions will be included in the block."` +通过让农民处理和创建区块，网络保持去中心化。 因为矿池无法知道哪个农民会赢得挑战，并且无权决定哪些交易将被包含在区块中。 --- -## Additional resources +## 附加资源 -### Links +### 链接 -- More [farming basics](https://docs.chia.net/farming-basics): overviews of plotting, pooling, and rewards. -- In depth [architecture overview](https://docs.chia.net/architecture-overview): describing the interactions between Farmers, Harvesters, Wallets, etc. -- Chialisp [detailed documentation](https://chialisp.com/): detailed information on all aspects of chialisp. +- 更多的[耕种基础知识](https://docs.chia.net/farming-basics)：绘图、矿池和奖励的概述。 +- 详细的[架构概述](https://docs.chia.net/architecture-overview)：描述农民、收割机、钱包等之间的交互。 +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 - Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-cat.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-cat.md new file mode 100644 index 0000000000..4d4a3db0bf --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-cat.md @@ -0,0 +1,97 @@ +--- +title: CATs +slug: /academy-cat +--- + +In this lesson, we talk about Chia Asset Tokens, and how they can be used. + +## 学习目标 + +- **Issuance**: Understand the basic types of issuance rules. + +--- + +## 内容 + +
+ +
+ +--- + +## 脚本 + +
+ + Expand for the full script + +0:00\ +A Chia Asset Token, or CAT, is a type of fungible token that can be minted from XCH. These tokens can take many different forms from a separate form of currency, to representing a collection of identical assets. + +0:20 +A CAT can have different properties, determined by it's TAIL, or Token Asset Issuance Limiter. This TAIL determines how the CAT is issued, how it can be subsequently spent, and whether it can be melted back into XCH. + +0:40 +A CAT wraps an inner puzzle that controls ownership of the coin. This is typically the standard transaction puzzle to facilitate sending the CATs to a Chia wallet. For the TAIL, there are 2 standard puzzles, Single-Issuance, and Multi-Issuance. +The Single-Issuance TAIL is more restrictive and is designed to make sure the supply is maintained. + +1:00 +With this TAIL, only the CATs minted at creation are valid, and they cannot be melted back into XCH. +The Multi-Issuance TAIL allows more identical CATs to be issued in the future, as long as the original issuance key is used. This is useful if the total number of tokens needed is unknown. + +1:20 +While these are the standard puzzles, a TAIL can be customized to allow any desired behavior. + +
+ +--- + +## 常见问题 + +- **Fungibility:** CATs are fungible, meaning they can be exchanged for each other at will. There are no editions, lot numbers, or anything else that would differentiate two CATs from the same issuance. +- **Melting:** Melting a CAT (if allowed by the TAIL) converts the underlying value of the CAT back to XCH which can then be used for other coins. A CAT can only ever be melted into the same amount of XCH used to create the CAT. + +--- + +## 知识检测 + +:::tip Question 1 - CATs vs. NFTs + +True or False; A CAT is a special type of NFT. + +::: + +
+ + Answer (expand when ready to see the answer) + +错误 A CAT is fungible, whereas an NFT is non-fungible and represents a unique item. + +
+ +:::tip Question 2 - TAILs + +What are the standard types of TAILs? + +::: + +
+ + Answer (expand when ready to see the answer) + +Single-Issuance and Multi-Issuance. + +
+ +--- + +## 附加资源 + +### 链接 + +- More about [primitives](https://docs.chia.net/guides/primitives/): guides for each primitive, and how to use them. +- In depth [CAT overview](https://docs.chia.net/guides/cat-creation-tutorial/): describing the CAT standard, and how to issue them. +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 +- Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-did.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-did.md new file mode 100644 index 0000000000..58cb382aa3 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-did.md @@ -0,0 +1,89 @@ +--- +title: DIDs +slug: /academy-did +--- + +This lesson is an overview of DIDs. + +## 学习目标 + +- **Identity Ownership**: Understand the differences in data ownership between decentralized and non-decentralized identities. + +--- + +## 内容 + +
+ +
+ +--- + +## 脚本 + +
+ + Expand for the full script + +0:00\ +DIDs, or decentralized identifiers, provide a way to identify users or organizations in a decentralized way. DIDs can be used as account identifiers. + +0:20 +For example, someone using a specific service would create a DID associated with that service that they control. They could use this DID to authorize access to the service, and manage assets the service may provide and permissions it may request. + +0:40 +In non-decentralized environments, the account information is controlled and owned by the service provider. With decentralized identities, the identity and the data associated with it, are controlled and owned by the user. This allows the user to use the DID with many different services and in many different contexts, and control the information associated with it. + +
+ +--- + +## 常见问题 + +- **DIDs are NFTs:** DIDs are actually a special type of NFT. This ensures uniqueness and that only one entitiy has control of any one DID. +- **DID limits:** A user can generate many DIDs and associate each one with different services or assets. + +--- + +## 知识检测 + +:::tip Question 1 - DID issuance + +True or False; A DID is issued by a service provider to identify a user. + +::: + +
+ + Answer (expand when ready to see the answer) + +错误 The DID is created by the user, and associated with a service provider. This allows the user to use one DID for many different services. + +
+ +:::tip Question 2 - DID limits + +How many DIDs can a user have? + +::: + +
+ + Answer (expand when ready to see the answer) + +There is no practical limit to the number of DIDs a user can create. + +
+ +--- + +## 附加资源 + +### 链接 + +- More about [primitives](https://docs.chia.net/guides/primitives/): guides for each primitive, and how to use them. +- In depth [DID guide](https://docs.chia.net/guides/nft-intro/): how to create a DID. +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 +- Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-nft.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-nft.md new file mode 100644 index 0000000000..3cd89c5cbc --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-nft.md @@ -0,0 +1,114 @@ +--- +title: NFTs +slug: /academy-nft +--- + +In this lesson, we talk about what an NFT is, and some examples of how it can be used. + +## 学习目标 + +- **Fungibility**: Understand what makes something fungible. +- **Uses and Value**: Understand the use of NFTs, and what makes something valuable. + +--- + +## 内容 + +
+ +
+ +--- + +## 脚本 + +
+ + Expand for the full script + +0:00\ +NFTs, or non-fungible tokens, can be used to provide proof of ownership, handle licenses and royalties, and ensure uniqueness for digital entities and even real-world items. + +0:20 +Let's start at the basics. An item is non-fungible if it can not be interchanged for another identical item. For example, an original painting, a driver's license, or even a family heirloom. These items are unique and can't be substituted for something of "equal value" since any other item would not have the same properties. + +0:40 +Since digital items can be inherently duplicated, we need to pair the item with something that isn't. An NFT is a token on the blockchain that represents an item. This item could be physical and the NFT is a sort of registry of ownership on the blockchain, or the item could be digital, with the NFT serving as the non-interchangeable component. + +1:00 +NFTs can be used to provide ownership provenance, such as the sale and resale of digital art. They can also provide a mechanism of distributing royalties to the original author upon resale. + +1:20 +NFTs can also provide a method of verifying and transferring more ethereal concepts such as digital memberships and ecosystem specific assets. +It's an important point that just because something is non-fungible, it is not inherently valuable. For example, a family heirloom is non-fungible, and may have emotional value to one person, + +1:40 +but it does not have true value outside of a specific context. NFTs are a tool that is useful for providing a new way to work with digital items. They do not themselves create value. + +
+ +--- + +## 常见问题 + +- **Size Limitations:** Because there is a limit to how large a single transaction can be, it is very rare to have the digital item itself embedded in the NFT. The token will instead contain a reference to the item that is hosted elsewhere. +- **NFTs are Data:** It is common to think of some type of image or art when thinking of NFTs. This is a very limited view. NFTs are essentially data objects that can contain references to other digital assets, or simply be the data object itself. The referenced asset may be a piece of digital art, but it could just as easily be a document, contract, application, etc. + +--- + +## 知识检测 + +:::tip Question 1 - Fungibility + +What makes something fungible? + +::: + +
+ + Answer (expand when ready to see the answer) + +Something is fungibile if it can be easily substituted for another item. + +
+ +:::tip Question 2 - Physical vs. Digital + +True or False; An NFT can really only represent digital assets. + +::: + +
+ + Answer (expand when ready to see the answer) + +错误 An NFT can also represent physical assets, and serves as a registry on the blockchain. + +
+ +:::tip Question 3 - Value + +True or False; Minting and NFT makes the underlying asset valuable. + +::: + +
+ + Answer (expand when ready to see the answer) + +错误 Simply being an NFT does not make it valuable. NFTs are a tool to handle digital assets in a new way. + +
+ +--- + +## 附加资源 + +### 链接 + +- More about [primitives](https://docs.chia.net/guides/primitives/): guides for each primitive, and how to use them. +- In depth [NFT guide](https://docs.chia.net/guides/nft-intro/): how to mint an NFT. +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 +- Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-offers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-offers.md new file mode 100644 index 0000000000..8b5832bb0a --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/academy-offers.md @@ -0,0 +1,98 @@ +--- +title: Offers +slug: /academy-offers +--- + +In this lesson, we talk about Chia Offers and how they enables safe peer-to-peer trading. + +## 学习目标 + +- **Peer-to-peer trading**: Understand what offers are and how they enable P2P trading. +- **Managing offer files**: Learn how to share, accept, and cancel offers. + +--- + +## 内容 + +
+ +
+ +--- + +## 脚本 + +
+ + Expand for the full script + +0:00 +Chia Offers are used to trade assets between two parties safely and securely in a direct, peer-to-peer transaction. They can be used to trade any combination of assets including XCH, CATs, and NFTs. + +0:20 +When an offer is accepted, the trade happens atomically, meaning the entirety of the trade settles simultaneously with no counterparty risk. The creator of an offer specifies the assets they wish to offer as well as the assets they wish to receive. + +0:40 +An offer file is then created, represented as a string of characters containing an incomplete and partially signed spend bundle. The creator can then share this offer file through any means, such as email, QR code, and offer file exchange services. Anyone that sees an offer file and wants to accept the trade can do so by signing and completing the other side of the spend bundle and submit it to the blockchain to be settled atomically. + +1:00 +Assets with smart contracts attached such as NFTs that include creator royalties are also enforced. If a creator wishes to cancel an existing offer, they can simply spend any of the assets offered to invalidate it. + +1:20 +Offers can also be set to automatically expire after a certain amount of time if nobody takes it. Offer files allow for true peer-to-peer transactions, introducing a new way to create safe and decentralized liquid markets for assets on the Chia blockchain. + +
+ +--- + +## 常见问题 + +- **Locked coins:** Some wallets including the GUI Reference Wallet will indicate part of the balance of an asset as "locked" or "unspendable" if an Offer was created offering that asset. In truth, those coins aren't actually unspendable but if they _are_ spent, any offer(s) that use those coins will be invalid. In order to not lock up more than the offered amount, one can split their coins into smaller amounts prior to creating an offer. +- **Canceling open offers:** If an offer has been previously shared (e.g. uploaded to dexie) and the creator wishes to cancel it, they need to cancel with the "Cancel on blockchain" function enabled to ensure the offer is truly invalidated and not just deleted locally. +- **Blockchain fees:** Accepting an offer is an on-chain transaction and hence requires a transaction fee to be prioritized when blocks are full. The creator can embed fees as part of the offer file but the buyer can also optionally include a transaction fee as well. + +--- + +## 知识检测 + +:::tip Question 1 - Supported assets + +True or False; An offer file is only for trading NFTs. + +::: + +
+ + Answer (expand when ready to see the answer) + +错误 An offer file can be used to trade any combination of assets including (but not limited to) XCH, CATs, and NFTs. Offer files can also be used with other types of coins such as Verifiable Credentials or DataLayer singletons. + +
+ +:::tip Question 2 - NFT Royalties + +True or False; When creating an offer for NFTs, creator royalties (if any) must be included. + +::: + +
+ + Answer (expand when ready to see the answer) + +True. If an NFT specifies a creator royalty, this amount must be included as part of the requested assets to be considered valid. Royalties are applied to XCH and CATs that are a part of the offer. Wallets will automatically calculate and include these coins to be sent to the NFT creator. + +
+ +--- + +## 附加资源 + +### 链接 + +- More about [primitives](https://docs.chia.net/guides/primitives/): guides for each primitive, and how to use them. +- CLI [Guide](https://docs.chia.net/guides/crash-course/cats-offers-nfts/#offers): documentation on how to interact with offers with the CLI. +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 +- Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. +- Offer file [exchanges](https://dexie.space): a bulletin board system for sharing and discovering offer files. + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/primitives-overview.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/primitives-overview.md new file mode 100644 index 0000000000..9b003c1615 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/primitives/primitives-overview.md @@ -0,0 +1,106 @@ +--- +title: Primitives Overview +slug: /primitives-overview +--- + +In this lesson, we talk about what a primitive is, and how it can be used. + +## 学习目标 + +- **Primitives**: Recognize the basic Chia primitives. +- **Open-Source**: Understand how open-source improves Chia through community involvement. + +--- + +## 内容 + +
+ +
+ +--- + +## 脚本 + +
+ + Expand for the full script + +0:00\ +Primitives are what we call commonly used structures in Chialisp. They are essentially features that are specifically supported with native methods in our various libraries, and have defined structures to ensure compatibility. + +0:20 +These Primitives include features commonly found in other blockchains such as NFTs and DIDs, but also include unique features such as CATs, Offers, Clawback, and Verifiable Credentials. +These primitives are the building blocks to creating efficient blockchain powered applications. + +0:40 +Each primitive represents a Chialisp puzzle that adheres to the current standard for that feature. These standards are submitted and can be modified by the community through the CHIP process, whereby new features, or modifications to existing primitives can be submitted and reviewed by community members, in keeping with the open-source nature of the Chia Blockchain. + +1:00 +Many of our unique primitives have come out of this process and it ensures that as development matures, the blockchain will evolve to satisfy the needs of developers in a multitude of use-cases. + +
+ +--- + +## 常见问题 + +- **Primitives as Standards:** Primitives are pre-defined features that adhere to certain standards agreed upon by the community. That does not mean that custom bespoke features cannot be developed or used for a specific use-case, even if it is not widely used. Chialisp allows any developer to create custom puzzles that map to their specific use-case, if an existing primitive does not quite fit. + +--- + +## 知识检测 + +:::tip Question 1 - Features + +True or False; Primitives are standardized features of the Chia Blockchain. + +::: + +
+ + Answer (expand when ready to see the answer) + +True. Primitives are what we call features that have defined standards, as agreed upon by the community. + +
+ +:::tip Question 2 - CHIPs? + +What does CHIP stand for? + +::: + +
+ + Answer (expand when ready to see the answer) + +CHIP stands for CHia Improvement Proposal. It is a way for the community of developers to propose new features, or changes to existing features. + +
+ +:::tip Question 3 - Custom Features + +True or False; Developers should only use pre-defined primitives. + +::: + +
+ + Answer (expand when ready to see the answer) + +错误 Primitives are meant to provide common and useful building blocks that are flexible to cover many use-cases. However, there may be instances where the existing primitives don't provide the needed functionality and a custom puzzle will be needed. + +
+ +--- + +## 附加资源 + +### 链接 + +- More about [primitives](https://docs.chia.net/guides/primitives/): guides for each primitive, and how to use them. +- Chialisp[详细文档](https://chialisp.com/)：提供有关Chialisp各个方面的详细信息。 +- Support [in discord](https://discord.gg/chia): for further support join our discord server and ask in the #chialisp or #support channels. + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md index f8338c3c13..1c76be1a45 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md @@ -1,6 +1,6 @@ --- title: 架构概览 -slug: /architecture-overview +slug: 架构概览 --- ![chia架构](/img/chia-network-architecture.png) diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md index 7bfa2a7422..52082be761 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md @@ -1,6 +1,6 @@ --- title: 耕种 -slug: /farmer-architecture +slug: 耕种架构 --- Chia的农民与比特币矿工相似。 他们通过在其储存的地块中找到有效的空间证明来获得区块奖励和费用。 耕种进程并不会保留一个区块链的副本，而由他们信任的一个完整节点来提供更新。 完整节点和耕种进程使用耕种协议相互沟通。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md index 89e247aef1..6d4110c10b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md @@ -1,6 +1,6 @@ --- title: 全节点 -slug: /full-node-architecture +slug: /全节点架构 --- Chia点对点系统的核心由全节点组成。 全节点有以下几项责任： diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md index 419cd25cd3..1fbb019373 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md @@ -1,6 +1,6 @@ --- title: 收割机 -slug: /harvester-architecture +slug: 收割机架构 --- 收割机是一些独立的机器，由农民控制。 在大规模耕作活动中，农民可能与许多收割机连接在一起。 @@ -16,7 +16,7 @@ slug: /harvester-architecture 就大多数挑战而言，质量 ( 步骤1) 很低，所以没有必要获取全部证明（步骤2）。 一个节点有28秒的时间返回一个证明，所以磁盘I/O 不会是一个限制因素， 即使证明存储在慢速HDD上。 -:::note +:::注意： 磁带驱动器太慢无法耕种。 The protocol was designed to support hard disks, but nothing slower. It is possible to use tape for long-term plot storage, only transferring the plots to disks for occasional farming, but this is likely a very rare use case. ::: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/mempool.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/mempool.md index ae026edc4d..74853dcd98 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/mempool.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/mempool.md @@ -7,6 +7,8 @@ The mempool (or memory pool) is a collection of transactions stored by full node The mempool is a required facet of Chia due to the decentralized nature of the blockchain. Transaction blocks occur approximately every 52 seconds, and it's impossible to predict who will win a block. Therefore, all transactions must be broadcast to the whole network and stored locally until they are confirmed. Additionally, it is normal to have more pending transactions than can fit in a single block, so the mempool also acts as a queue for inclusion into the blockchain. +For more information about the mempool, see our [blog post](https://www.chia.net/2024/01/11/getting-to-know-the-mempool-and-transaction-fees/) on this subject. + :::info How many transactions can fit into a block? Due to the varying size of transactions, and the different definitions of what even counts as a "transaction," there is not an exact number. But just for a bit of rough guidance, approximately 1000 transactions with two inputs and two outputs, or 2000 transactions with one input and one output can fit into a single block. ::: @@ -27,52 +29,60 @@ To view the current status of the mempool, see the dashboard for [mainnet](https :::info -Currently, the block size is artificially limited to 50% of its capacity. Eventually this limitation will be lifted, but the numbers discussed in this section assume it is being enforced. - -::: - -:::info - -The total size of the mempool differs by network. - -- Mainnet: 550 billion cost, or 100 blocks -- Testnet10: 110 billion cost, or 20 blocks +- By default, the total size of the mempool is 20 blocks. This true for both mainnet and testnet11. +- Prior to version 2.2, the block size was artificially capped at 50% of its capacity. +- Starting in version 2.2, the block size cap was increased to 60%. +- This limitation will be increased gradually, until it reaches 100%, or 11 billion cost -- the limit enforced by the consensus rules. +- The size (in CLVM cost) of the mempool is `mempool blocks * max cost per block * block size limit`. + - In version 2.2, this amounts to `20 * 11 billion * 0.6`, which equals 132 billion. + - When the block limiter is lifted, the total size will be `20 * 11 billion`, or 220 billion. ::: ### Scenario 1: Mempool Not Busy -If the transaction you just submitted -- plus the entire contents of the mempool -- can fit into one block, then your transaction will be added to the next block. This is true even if you don't include a transaction fee. +If the transaction you just submitted -- plus the entire contents of the mempool -- can fit into one block, then your transaction will be added to the next block. This is true even if you don't include a transaction fee. This is true even if you don't include a transaction fee. -The reason for this is straightforward -- the farmer has nothing to gain by excluding certain transactions, so it will include everything. Note that some proprietary software takes the opposite approach: the farmer will _only_ include transactions that pay a fee, regardless of mempool size. +The reason for this is straightforward -- the farmer has nothing to gain by excluding certain transactions, so it will include everything. The reason for this is straightforward -- the farmer has nothing to gain by excluding certain transactions, so it will include everything. Note that some proprietary software takes the opposite approach: the farmer will _only_ include transactions that pay a fee, regardless of mempool size. The mempool for Chia's mainnet is often in this state. This does not mean that no transactions are being submitted. It simply means that the network's speed of around 20 transactions per second is sufficient to keep up with demand. ### Scenario 2: Mempool Busy But Not Full -If the mempool's contents will occupy more than one block, but the mempool is not full, then it is considered _busy_. In this case: +If the mempool's contents will occupy more than one block, but the mempool is not full, then it is considered _busy_. In this case: In this case: -- Transactions that don't include fees will be added to the mempool, but they won't make it into the next block. Instead, they will have to "wait in line" for higher-priority transactions to be cleared. They likely will eventually be included in a block, but this is not guaranteed. -- Transactions with fees will be added to the mempool and prioritized according to the size of their fee-per-cost. For example, a transaction with a 1-mojo fee will enter the queue ahead of zero-fee transactions. +- Transactions that don't include fees will be added to the mempool, but they won't make it into the next block. Instead, they will have to "wait in line" for higher-priority transactions to be cleared. They likely will eventually be included in a block, but this is not guaranteed. Instead, they will have to "wait in line" for higher-priority transactions to be cleared. They likely will eventually be included in a block, but this is not guaranteed. +- Transactions with fees will be added to the mempool and prioritized according to the size of their fee-per-cost. Transactions with fees will be added to the mempool and prioritized according to the size of their fee-per-cost. For example, a transaction with a 1-mojo fee will enter the queue ahead of zero-fee transactions. :::info Testnet10 info -Testnet10 is constantly being "dusted" (thousands of small transactions are being included) in order to simulate a busy network, which can be useful for testing. The dust transactions do not include any fees, so in order for your transaction to be prioritized ahead of the dust, you simply have to include a 1-mojo fee. In this case, your transaction will likely be included in the next transaction block. However, if you don't include a fee, it will likely need to wait ~40-60 minutes before being included. +Testnet10 is constantly being "dusted" (thousands of small transactions are being included) in order to simulate a busy network, which can be useful for testing. The dust transactions do not include any fees, so in order for your transaction to be prioritized ahead of the dust, you simply have to include a 1-mojo fee. In this case, your transaction will likely be included in the next transaction block. However, if you don't include a fee, it will likely need to wait ~40-60 minutes before being included. The dust transactions do not include any fees, so in order for your transaction to be prioritized ahead of the dust, you simply have to include a 1-mojo fee. In this case, your transaction will likely be included in the next transaction block. However, if you don't include a fee, it will likely need to wait ~40-60 minutes before being included. ::: ### Scenario 3: Mempool Full -If the mempool is completely full, then in order for your transaction to be added, it will need to kick out one or more transactions. In this scenario: +If the mempool is completely full, then in order for your transaction to be added, it will need to kick out one or more transactions. In this scenario: In this scenario: - Transactions with no fee will not be added to the mempool. - Transactions with a fee of less than five mojos per cost (~100 million mojos for 2-input, 2-output transactions) will be treated as zero-fee transactions, i.e. they will not be added to the mempool. - Transactions with a fee of at least five mojos per cost will be added to the mempool, prioritized by fee-per-cost, _if_ they are not the lowest priority transactions. In this case, one or more of the lowest-priority transactions will be removed. -- If the lowest-cost transaction in the mempool is higher than than the new transaction, then the new transaction will not be added. For example, if the lowest priority transaction in the mempool has a fee of 100 mojos-per-cost (as might be the case in a very busy network), then a new transaction will have to include a higher fee in order to be added to the mempool. -This scenario often occurs on testnet10. When the mempool is completely full, the dusters stop submitting transactions until some of the dust has been cleared. This scenario might occasionally happen on mainnet as well, in which case a minimum fee would be required. +This scenario often occurs on testnet11. This scenario often occurs on testnet10. When the mempool is completely full, the dusters stop submitting transactions until some of the dust has been cleared. This scenario might occasionally happen on mainnet as well, in which case a minimum fee would be required. This scenario might occasionally happen on mainnet as well, in which case a minimum fee would be required. + +If you see `INVALID_FEE_TOO_CLOSE_TO_ZERO` in your log file, the mempool was likely full when you submitted your transaction, and you did not include a sufficient fee to kick out an existing transaction. Try resubmitting your transaction with a higher fee. Try resubmitting your transaction with a higher fee. -If you see `INVALID_FEE_TOO_CLOSE_TO_ZERO` in your log file, the mempool was likely full when you submitted your transaction, and you did not include a sufficient fee to kick out an existing transaction. Try resubmitting your transaction with a higher fee. +### Scenario 4: Mempool Full of Transactions with Fees + +This is the final scenario, where every transaction in the mempool has a fee of at least five mojos per cost. In order for your transaction to be added, it will need to kick out one or more transactions. In this scenario: + +- Transactions with no fee will not be added to the mempool. +- Transactions with a fee of less than five mojos per cost (~100 million mojos for 2-input, 2-output transactions) will be treated as zero-fee transactions, i.e. they will not be added to the mempool. +- Transactions with a fee of at least five mojos per cost _might_ be added to mempool. For this to happen, they will need to kick out one or more transactions with a lower fee-per-cost ratio. For example: + - If the "cheapest" transaction currently in the mempool has a fee per cost of 10, and your transaction's fee per cost is 9, then your transaction will not be added to the mempool. + - If the "cheapest" transaction is 10, and yours is 15, then it likely will be added. However, even in this case, there are scenarios where your transaction might not be added, such as when the lowest-cost transaction currently in the mempool is quite large. + +If the mempool from Chia's mainnet reaches this state, the competition for block space will be strong. In order for your transaction to be included, the minimum fee might be significantly higher than it would be in the other scenarios. ## Replace by Fee @@ -80,6 +90,15 @@ A transaction can replace another transaction in the mempool if it spends at lea For example, if the original transaction spent coins A and B, then another transaction that spends A, B, and C can replace it. However, a transaction that spends B and C cannot. This prevents denial-of-service (DOS) attacks, as well as censorship of transactions. There is also a minimum fee bump which might depend on mempool software being used. In `chia-blockchain`, this is set to 5 fee-per-cost. This prevents spam replacement transactions. +The full conditions for replace by fee are: + +1. The new spend bundle needs to include at least all the spends in the original one (can include additional spends) +2. The new spend bundle needs to pay a higher fee per cost than the original one (and higher than the [minimum fee required for inclusion](https://docs.chia.net/mempool/#fee-required-for-inclusion)) +3. The new spend bundle needs to pay at least 10000000 mojos more in fees than the original one +4. If there were any time-locks associated with the original spend, the new spend bundle has to have the same time-lock + +The replace by fee logic can be found [here](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/full_node/mempool_manager.py#L678)in the codebase) + ## Block Creation When the farmer makes a block, they will select the highest fee-per-cost transactions from the mempool until they reach the maximum block size. These spend bundles are combined into one large spend bundle, which is guaranteed to be valid, since all spend bundles in the mempool must spend disjointed coins. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/timelords.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/timelords.md index 5504a9a87b..d48ae1f0cc 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/timelords.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/timelords.md @@ -27,7 +27,7 @@ You can learn about potential attacks against Chia's network in the [Attacks and There are two primary types of Timelords: Regular and Blueboxes. -The first is the core Timelord that takes in Proofs of Space and uses a single fastest core to perform repeated squaring in a [class group of unknown order](https://github.com/Chia-Network/vdf-competition/blob/master/classgroups.pdf) as fast as possible. Beside each running VDF (referred to as a vdf_client in the application and source) is a set of proof generation threads that accumulate the proof that the time calculation's number of iterations was done correctly. +The first is the core Timelord and can be either a software Timelord or a hardware Timelord (ASIC) that takes in Proofs of Space and uses a single fastest core to perform repeated squaring in a [class group of unknown order](https://github.com/Chia-Network/vdf-competition/blob/master/classgroups.pdf) as fast as possible. Beside each running VDF (referred to as a vdf_client in the application and source) is a set of proof generation threads that accumulate the proof that the time calculation's number of iterations was done correctly. The second are Bluebox Timelords. Blueboxes are most any machine - especially things like old servers or gaming machines - that scour the historical chain looking for uncompressed proofs of time. So that the chain moves quickly, the regular Timelords use a faster method of generating proofs of time but the proofs are larger, which takes your Raspberry Pi a lot more time and effort to validate and sync the blockchain. A Bluebox picks up an uncompressed Proof of Time and recreates it, but this time with the slower and more compact proofs generated at the end. Those are then gossiped around to everyone so they can replace the large and slow to verify Proofs of Time with the compact and much quicker to validate version of exactly the same thing. @@ -39,38 +39,19 @@ It's good to have a few Timelords out there. There can be things like routing fl The Company plans to run a few Timelords around the world - and some backups too - to ensure that all Farmers and nodes can hear the beat that the Timelords are calling. -## Installing a Timelord +For installation and usage documentation please refer [here](/timelord-install). -:::info -If you want to run a Timelord on Linux/MacOS, first follow the Install from Source instructions [here](/installation#from-source). Then run: - -```bash -. ./activate -sh install-timelord.sh -chia start timelord & -``` - -::: - -Timelords execute sequential verifiable delay functions (proofs of time or VDFs), that get added to blocks to make them valid. This requires fast CPUs and a few cores per VDF. - -Due to restrictions on how [MSVC](https://en.wikipedia.org/wiki/Microsoft_Visual_C%2B%2B) handles 128 bit numbers and how Python relies upon MSVC, it is not possible to build and run Timelords of all types on Windows. - -### Regular Timelords - -On MacOS x86_64 and all Linux distributions, building a Timelord is as easy as running `chia start timelord &` in the virtual environment. You can also run `./vdf_bench square_asm 400000` once you've built Timelord to give you a sense of your optimal and unloaded ips. Each run of `vdf_bench` can be surprisingly variable and, in production, the actual ips you will obtain will usually be about 20% lower due to load of creating proofs. The default configuration for Timelords is good enough to just let you start it up. Set your log level to INFO and then grep for "Estimated IPS:" to get a sense of what actual ips your Timelord is achieving. - -### Bluebox Timelords +## Troubleshooting a Timelord -Once you build the Timelord with `sh install-timelord.sh` in the virtual environment, you will need to make two changes to `~/.chia/VERSION/config.yaml`. In the `timelord:` section, set `bluebox_mode:` to `True`. Then you need to proceed to the `full_node:` section and set `send_uncompact_interval:` to something greater than 0. We recommend `300` seconds there so that your Bluebox has some time to prove through a lot of the un-compacted Proofs of Time before the node drops more into its lap. The default settings may otherwise work but if the total effort is a little too much for whatever machine you are on you can also lower the `process_count:` from 3 to 2, or even 1, in the `timelord_launcher:` section. You know it is working if you see `VDF Client: Sent proof` in your logs at INFO level. +For troubleshooting steps please refer to the documentation [here](/troubleshooting/timelords). ## The Future of Timelords -In 2023, CNI received its first batch of ASIC timelords. When run as a cluster of three VDFs, these timelords could hit upwards of one million IPS. This was approximately four times the speed of the fastest non-ASIC timelords. After installing several timelords in strategic locations globally, and after thorough testing on private testnets, the company added the ASICs to the biggest public testnet -- testnet10. Finally, after [years of designing](https://www.businesswire.com/news/home/20211013005324/en/Chia-Partners-With-Supranational-to-Create-Industry-Leading-Proof-of-Space-Time-Security) the ASICs and months of testing them, they were activated on mainnet in October 2023. +In 2023, CNI received its first batch of ASIC timelords. When run as a cluster of three VDFs, these timelords could hit upwards of one million IPS. This was approximately four times the speed of the fastest non-ASIC timelords. After installing several timelords in strategic locations globally, and after thorough testing on private testnets, the company added the ASICs to a public testnet. Finally, after [years of designing](https://www.businesswire.com/news/home/20211013005324/en/Chia-Partners-With-Supranational-to-Create-Industry-Leading-Proof-of-Space-Time-Security) the ASICs and months of testing them, they were activated on mainnet in October 2023. -The next step is to distribute some of the remaining ASIC timelords to a select list of applicants, as detailed in a [blog post](https://www.chia.net/2023/10/26/asic-timelords-faster-than-fast-chia-network/). This process will ensure a high amount of global redundancy on this critical network infrastructure. +The next step was to distribute some of the remaining ASIC timelords to a select list of applicants, as detailed in a [blog post](https://www.chia.net/2023/10/26/asic-timelords-faster-than-fast-chia-network/). This process ensures a high amount of global redundancy on this critical network infrastructure. -Of course, as technology improves, the ASIC design will need to be updated. However, this process is extremely costly, and the current generation is already pushing upon the limits imposed by the laws of physics. We expect the current crop to remain the fastest timelords in the world for years to come. +Of course, as technology improves, the ASIC design will need to be updated. However, this process is extremely costly, and the current generation is already pushing upon the limits imposed by the laws of physics. We expect the current crop to remain the fastest timelords in the world for years to come. However, this process is extremely costly, and the current generation is already pushing upon the limits imposed by the laws of physics. We expect the current crop to remain the fastest timelords in the world for years to come. ## Timelords and Attacks diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md index 1d01d5dcef..ebb6018ea2 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md @@ -1,6 +1,6 @@ --- title: 区块格式 -slug: /block-format +slug: /区块格式 --- ## 完整块 @@ -19,7 +19,7 @@ slug: /block-format - **foliage**: Foliage: Foliage data for the reward chain block, the hash of this is the `header_hash`. - **foliage_transaction_block**: Optional[FoliageTransactionBlock]: Transaction related metadata that is relevant for light clients (not actual transactions), only for tx blocks. - **transactions_info**: Optional[TransactionsInfo]: Transaction related metadata that is not relevant for light clients (not actual transactions), only for tx blocks. -- **transactions_generator**: Optional[SerializedProgram]: A clvm program that generates all transactions (spends). +- **transactions_generator**: Optional[SerializedProgram]: A clvm program that generates all transactions (spends). See the next section for an important [update](#transactions_generator-update) due to the 2.1.0 hard fork. - **transactions_generator_ref_list**: List[uint32]: A list of block heights of previous generators referenced by this block's generator. ## transactions_generator update diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md index 5418957a8c..720f2c288a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md @@ -7,7 +7,7 @@ In Chia, the issuance schedule, also referred to as the block reward schedule, d ## Strategic Reserve (pre-farm) -The first block of the network pays out 21 million XCH, divided into a 1/8 coin and a 7/8 coin, to an address that Chia Network Inc controls. The purpose and future usage of the funds is described in the [business whitepaper](https://www.chia.net/whitepaper). +The first block of the network pays out 21 million XCH, divided into a 1/8 coin and a 7/8 coin, to an address that Chia Network Inc controls. The purpose and future usage of the funds is described in the [business white paper](https://www.chia.net/whitepaper). ## Halvings @@ -36,7 +36,7 @@ Therefore, Chia coins are never destroyed. In a given block, any portion of a sp ## Farmer vs Pool reward -The block reward is divided into two coins. The first coin goes to the farmer puzzle hash, which is specified by the farmer, and usually goes straight to the farmer's wallet. This contains 1/8 of the total value (0.25 XCH for the first 3 years). This is referred to as the _farmer coin_. +The block reward is divided into two coins. The first coin goes to the farmer puzzle hash, which is specified by the farmer, and usually goes straight to the farmer's wallet. This contains 1/8 of the total value. This is referred to as the _farmer coin_. The second coin, with 7/8 of the value, is called the _pool coin_. This coin can go to one of two places: @@ -48,11 +48,11 @@ The second coin, with 7/8 of the value, is called the _pool coin_. This coin can As detailed in the [Business white paper](https://www.chia.net/whitepaper), the network's emissions schedule is as follows: | Years | Final
Block | Final Month
(Approx.) | Block Reward
(total) | Pool
Reward | Farmer
Reward | -| ------: | --------------: | ------------------------: | -----------------------: | --------------: | ----------------: | -| 1 - 3 | `5 045 760` | March 2024 | 2 XCH | 1.75 XCH | 0.25 XCH | -| 4 - 6 | `10 091 520` | March 2027 | 1 XCH | 0.785 XCH | 0.125 XCH | -| 7 - 9 | `15 137 280` | March 2030 | 0.5 XCH | 0.4375 XCH | 0.0625 XCH | -| 10 - 12 | `20 183 040` | March 2033 | 0.25 XCH | 0.21875 XCH | 0.03125 XCH | -| 13 - ∞ | ∞ | ∞ | 0.125 XCH | 0.109375 XCH | 0.015625 XCH | - -Note that the rewards are adjusted according to a block height, not a timestamp. The `Final Block` column is therefore accurate as the last block before the rewards are modified. The months and years are only estimates based on when the block heights are likely to be reached. +| -------:| ---------------------:| -------------------------------:| ------------------------------:| ---------------------:| -----------------------:| +| 1 - 3 | `5 045 760` | March 2024 | 2 XCH | 1.75 XCH | 0.25 XCH | +| 4 - 6 | `10 091 520` | March 2027 | 1 XCH | 0.785 XCH | 0.125 XCH | +| 7 - 9 | `15 137 280` | March 2030 | 0.5 XCH | 0.4375 XCH | 0.0625 XCH | +| 10 - 12 | `20 183 040` | March 2033 | 0.25 XCH | 0.21875 XCH | 0.03125 XCH | +| 13 - ∞ | ∞ | ∞ | 0.125 XCH | 0.109375 XCH | 0.015625 XCH | + +Note that the rewards are adjusted according to a block height, not a timestamp. Note that the rewards are adjusted according to a block height, not a timestamp. The `Final Block` column is therefore accurate as the last block before the rewards are modified. The months and years are only estimates based on when the block heights are likely to be reached. The months and years are only estimates based on when the block heights are likely to be reached. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md new file mode 100644 index 0000000000..dde1107ab6 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md @@ -0,0 +1,119 @@ +--- +sidebar_label: ASICs +title: ASICs HW VDF +slug: /asic-cli +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +## Reference + +### `hw_vdf_client` + +Functionality: Run the ASIC HW VDF Software + +Usage: hw_vdf_client [OPTIONS] PORT [N_VDFS] + +Options: + +| Long Command | Type | Required | Description | +| :----------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------- | +| --freq | INTEGER | False | set ASIC frequency [%d, 200 - 2200] | +| --voltage | INTEGER | False | set board voltage [.88, 0.7 - 1.0] | +| --ip | TEXT | False | timelord IP address [localhost] | +| --vdfs-mask | TEXT | False | mask for enabling VDF engines [7, 1 - 7] | +| --vdf-threads | TEXT | False | number of software threads per VDF engine [4, 2 - 64] | +| --proof-threads | TEXT | False | number of proof threads per VDF engine [3, 1 - 63] | +| --auto-freq-period | TEXT | False | auto-adjust frequency every N seconds [0, 10 - inf] | +| --list | TEXT | False | list available devices and exit | +| --help | None | False | Show a help message and exit | + +
+Example 1 - Run the ASIC software with defaults + +```bash +hw_vdf_client 8000 3 +``` + +Response: + +``` +2024-04-12T10:32:05.898 Setting frequency to 1100.000000 MHz +2024-04-12T10:32:06.016 Frequency is 1100.000000 MHz +2024-04-12T10:32:06.020 Board voltage is 0.875 V +2024-04-12T10:32:06.020 Setting voltage to 0.880 V +2024-04-12T10:32:06.021 Board voltage is now 0.875 V +2024-04-12T10:32:06.032 Board current is 0.698 A +2024-04-12T10:32:06.043 Board power is 0.610 W +2024-04-12T10:32:06.049 Connecting to 127.0.0.1:8000 +2024-04-12T10:32:06.049 VDF 0: Connected to timelord, waiting for challenge +``` + +
+ +
+Example 2 - Run the ASIC software with auto-frequency, initial frequency, and defined ip + +```bash +hw_vdf_client --freq 1500 --auto-freq 60 --ip 192.168.0.122 8000 3 +``` + +Response: + +``` +2024-04-12T10:32:05.898 Setting frequency to 1500.000000 MHz +2024-04-12T10:32:06.016 Frequency is 1500.000000 MHz +2024-04-12T10:32:06.020 Board voltage is 0.875 V +2024-04-12T10:32:06.020 Setting voltage to 0.880 V +2024-04-12T10:32:06.021 Board voltage is now 0.875 V +2024-04-12T10:32:06.032 Board current is 0.698 A +2024-04-12T10:32:06.043 Board power is 0.610 W +2024-04-12T10:32:06.049 Connecting to 192.168.0.122:8000 +2024-04-12T10:32:06.049 VDF 0: Connected to timelord, waiting for challenge +``` + +
+ +
+Example 3 - Run the ASIC software with defined ip and only 1 vdf (i.e. defaults for cluster) + +```bash +hw_vdf_client --ip 192.168.0.122 8000 1 +``` + +Response: + +``` +2024-04-12T10:32:05.898 Setting frequency to 1100.000000 MHz +2024-04-12T10:32:06.016 Frequency is 1100.000000 MHz +2024-04-12T10:32:06.020 Board voltage is 0.875 V +2024-04-12T10:32:06.020 Setting voltage to 0.880 V +2024-04-12T10:32:06.021 Board voltage is now 0.875 V +2024-04-12T10:32:06.032 Board current is 0.698 A +2024-04-12T10:32:06.043 Board power is 0.610 W +2024-04-12T10:32:06.049 Connecting to 192.168.0.122:8000 +2024-04-12T10:32:06.049 VDF 0: Connected to timelord, waiting for challenge +``` + +
+ +--- + +## Troubleshooting a Timelord + +For troubleshooting steps please refer to the documentation [here](/troubleshooting/timelords). + +--- + +## Timelord support + +Join Our [Discord](https://discord.gg/chia) and jump into the #support channel for support + +--- + +## Timelord FAQ + +For FAQ please refer to the documentation [here](/timelord-install#timelord-faq). + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md index 5e2194b162..34bce54639 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md @@ -23,27 +23,27 @@ Usage: cats [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| -l | --tail | TEXT | True | The TAIL program to launch this CAT with | -| -c | --curry | TEXT | False | An argument to curry into the TAIL | -| -s | --solution | TEXT | False | The solution to the TAIL program [default: ()] | -| -t | --send-to | TEXT | True | The address these CATs will appear at once they are issued | -| -a | --amount | INTEGER | True | The amount to issue in mojos (regular XCH will be used to fund this) | -| -m | --fee | INTEGER | False | The fees for the transaction, in mojos [default: 0] | -| -d | --authorized-provider | TEXT | False | A trusted DID that can issue VCs that are allowed to trade the CAT. Specifying this option will make the CAT a CR (credential restricted) CAT. Requires specifying either `--proofs-checker` or `--cr-flag` | -| -r | --proofs-checker | TEXT | False | The program that checks the proofs of a VC for a CR-CAT. Specifying this option requires a value for `--authorized-providers` | -| -v | --cr-flag | TEXT | False | Specify a list of flags to check a VC for in order to authorize this CR-CAT. Specifying this option requires a value for `--authorized-providers`. Cannot be used if a custom `--proofs-checker` is specified. | -| -f | --fingerprint | INTEGER | False | The wallet fingerprint to use as funds | -| -sig | --signature | TEXT | False | A signature to aggregate with the transaction | -| -as | --spend | TEXT | False | An additional spend to aggregate with the transaction | -| -b | --as-bytes | None | False | Output the spend bundle as a sequence of bytes instead of JSON | -| -sc | --select-coin | None | False | Stop the process once a coin from the wallet has been selected and return the coin | -| -q | --quiet | None | False | Quiet mode will not ask to push transaction to the network | -| -p | --push | None | False | Automatically push transaction to the network in quiet mode | -| | --root-path | PATH | False | The root folder where the config lies [default: ~/.chia/mainnet] | -| | --wallet-rpc-port | INTEGER | False | The RPC port the wallet service is running on | -| | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| -l | --tail | TEXT | True | The TAIL program to launch this CAT with | +| -c | --curry | TEXT | False | An argument to curry into the TAIL | +| -s | --solution | TEXT | False | The solution to the TAIL program [default: ()] | +| -t | --send-to | TEXT | True | The address these CATs will appear at once they are issued | +| -a | --amount | INTEGER | True | The amount to issue in mojos (regular XCH will be used to fund this) | +| -m | --fee | INTEGER | False | The fees for the transaction, in mojos [default: 0] | +| -d | --authorized-provider | TEXT | False | A trusted DID that can issue VCs that are allowed to trade the CAT. Specifying this option will make the CAT a CR (credential restricted) CAT. Requires specifying either `--proofs-checker` or `--cr-flag` Specifying this option will make the CAT a CR (credential restricted) CAT. Requires specifying either `--proofs-checker` or `--cr-flag` | +| -r | --proofs-checker | TEXT | False | The program that checks the proofs of a VC for a CR-CAT. Specifying this option requires a value for `--authorized-providers` Specifying this option requires a value for `--authorized-providers` | +| -v | --cr-flag | TEXT | False | Specify a list of flags to check a VC for in order to authorize this CR-CAT. Specifying this option requires a value for `--authorized-providers`. Cannot be used if a custom `--proofs-checker` is specified. Specifying this option requires a value for `--authorized-providers`. Cannot be used if a custom `--proofs-checker` is specified. | +| -f | --fingerprint | INTEGER | False | The wallet fingerprint to use as funds | +| -sig | --signature | TEXT | False | A signature to aggregate with the transaction | +| -as | --spend | TEXT | False | An additional spend to aggregate with the transaction | +| -b | --as-bytes | None | False | Output the spend bundle as a sequence of bytes instead of JSON | +| -sc | --select-coin | None | False | Stop the process once a coin from the wallet has been selected and return the coin | +| -q | --quiet | None | False | Quiet mode will not ask to push transaction to the network | +| -p | --push | None | False | Automatically push transaction to the network in quiet mode | +| | --root-path | PATH | False | The root folder where the config lies [default: ~/.chia/mainnet] | +| | --wallet-rpc-port | INTEGER | False | The RPC port the wallet service is running on | +| | --help | None | False | Show a help message and exit |
Example 1 - select a coin from the wallet with a value of at least 1 XCH (1 trillion mojos) @@ -94,7 +94,7 @@ After pushing the transaction, the new ID and Eve Coin (singleton parent coin) w
Example 3 - Mint a new CR-CAT -First, select a coin to use for the minting. Flags included in this example (CR-specific flags are in **bold**): +First, select a coin to use for the minting. First, select a coin to use for the minting. Flags included in this example (CR-specific flags are in **bold**): - `--tail`: The tail to use; in this case we'll use a single-issuance TAIL - `--send-to`: The address to send the CR-CATs to upon minting @@ -120,7 +120,7 @@ Response: Name: c5519ac8ef55043b23bef45b1326d445f2c4af579f13dc0cdec10335ccb0a809 ``` -In the above repsonse, `Name` is the ID of the coin to be used for the minting. Next, run the same command again, but remove the `--select-coin` flag and add `--curry 0x` (the `0x` is required and important here): +In the above repsonse, `Name` is the ID of the coin to be used for the minting. In the above repsonse, `Name` is the ID of the coin to be used for the minting. Next, run the same command again, but remove the `--select-coin` flag and add `--curry 0x` (the `0x` is required and important here): ```bash cats --tail ./reference_tails/genesis_by_coin_id.clsp.hex --send-to txch1ek6ln2ejdsec6l734x8tggk9j5sepl8nfqjer5yt2dr905f04prqmcjcc5 --authorized-provider did:chia:1x23lnyd2xjefnfly075ngk79duf0yxna35cp86mgnnp4t33senfs4cah7u --cr-flag "test_proof1" --amount 1000000 -m 1000 --as-bytes --curry 0xc5519ac8ef55043b23bef45b1326d445f2c4af579f13dc0cdec10335ccb0a809 @@ -134,9 +134,9 @@ Asset ID: 262a2c2cbb09414652006c4da139a186b3a110bb57cd5d76b6785e4811f1c77c Eve Coin ID: 692a4f63c56815a33510088a255d695aea472d0f03bb9f0d5cdd5c91a82821f2 ``` -Just as with standard CATs, the CR-CAT has been minted and sent to its destination address. `Asset ID` can now be added in the destination wallet. +Just as with standard CATs, the CR-CAT has been minted and sent to its destination address. `Asset ID` can now be added in the destination wallet. `Asset ID` can now be added in the destination wallet. -In this case, the destination wallet is the holder of a VC with the proof required to hold this CR-CAT. To verify this, run the `vcs get` CLI command: +In this case, the destination wallet is the holder of a VC with the proof required to hold this CR-CAT. To verify this, run the `vcs get` CLI command: To verify this, run the `vcs get` CLI command: ```bash chia wallet vcs get @@ -154,7 +154,7 @@ Inner Address: txch166pzqd55p2emp9sqaflvyc8x2s4qn4eexrxgrlfwf8khuefp5fqswe84mu Proof Hash: f063e22557705b14425b8fca60018796b4364eb6354f45d0b99431a71d3043e5 ``` -This VC contains the proof that was added to the CR-CAT (`test_proof1`). Once the CR-CAT has been added to this Chia wallet, it will be displayed as type `CRCAT`. For example: +This VC contains the proof that was added to the CR-CAT (`test_proof1`). Once the CR-CAT has been added to this Chia wallet, it will be displayed as type `CRCAT`. For example: Once the CR-CAT has been added to this Chia wallet, it will be displayed as type `CRCAT`. For example: ```bash chia wallet show @@ -186,7 +186,7 @@ Usage: secure_the_bag [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -c | --curry | TEXT | False | An argument to curry into the TAIL | | -a | --amount | INTEGER | True | The amount to issue in mojos (regular XCH will be used to fund this) | | -stbtp | --secure-the-bag-targets-path | TEXT | True | Path to CSV file containing targets of secure the bag (inner puzzle hash + amount). The total value of the coins in this file must match the value of the `amount` flag. If they don't match, an error will be thrown. | @@ -222,7 +222,7 @@ Usage: secure_the_bag [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------- | +|:------------- |:----------------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------- | | -ecid | --eve-coin-id | TEXT | True | ID of coin that was spent to create secured bag | | -th | --tail-hash | TEXT | True | TAIL hash / Asset ID of CAT to unwind from secured bag of CATs | | -stbtp | --secure-the-bag-targets-path | TEXT | True | Path to CSV file containing targets of secure the bag (inner puzzle hash + amount) | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md index 84ebeaa53a..99791ba0d8 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md @@ -36,14 +36,14 @@ Usage: `clawback [OPTIONS] COMMAND [ARGS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :--------------------------- | +|:------------- |:------------ |:---- |:-------- |:---------------------------- | | | --version | None | False | Show the version and exit | | -h | --help | None | False | Show a help message and exit | Commands: | Name | Description | -| :----- | :-------------------------------------------------- | +|:------ |:--------------------------------------------------- | | claim | Claim a clawback coin after the timelock has passed | | claw | Clawback an unclaimed coin | | create | Send xch to a clawback coin | @@ -60,7 +60,7 @@ Usage: `clawback claim [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -c | --coin-id | TEXT | True | The coin ID you want to claim | | -m | --fee | FLOAT | False | The fee in XCH for this transaction | | -w | --wallet-id | INTEGER | False | The wallet id for fees. If no target address given the clawback will go to this wallet id | @@ -245,7 +245,7 @@ Usage: `clawback claw [OPTIONS]` Options: Clawback an unclaimed coin | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -c | --coin-id | TEXT | True | The coin ID for the clawback coin to inspect | | -m | --fee | FLOAT | False | The fee in XCH for this transaction | | -w | --wallet-id | INTEGER | False | The wallet id for fees. If no target address given the clawback will go to this wallet id | @@ -317,7 +317,7 @@ Usage: `clawback create [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -t | --to | TEXT | True | The recipient's address | | -l | --timelock | INTEGER | False | The timelock to use for the clawback coin you're creating, in seconds. Default is two weeks | | -a | --amount | INTEGER | True | The amount to fund (in XCH) | @@ -410,7 +410,7 @@ Usage: `clawback show [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -c | --coin-id | TEXT | False | The coin ID for the clawback coin to inspect | | -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cli.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cli.md index c679cc1d61..8a502a05a5 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cli.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cli.md @@ -91,6 +91,22 @@ Command: `chia start {service}` `-r, --restart`: Restart of running processes +| | Full Node | Wallet | Farmer | Harvester | Timelord | Timelord Launcher | Timelord-Only | Introducer | Full Node Simulator | +| ----------------- | --------- | ------ | ------ | --------- | -------- | ----------------- | ------------- | ---------- | ------------------- | +| all | X | X | X | X | X | X | | | | +| node | X | | | | | | | | | +| harvester | | | | X | | | | | | +| farmer | X | X | X | X | | | | | | +| farmer-no-wallet | X | | X | X | | | | | | +| farmer-only | | | X | | | | | | | +| timelord | X | | | | X | X | | | | +| timelord-only | | | | | X | | X | | | +| timelord-launcher | | | | | | X | | | | +| wallet | X | X | | | | | | | | +| wallet-only | | X | | | | | | | | +| introducer | | | | | | | | X | | +| simulator | | | | | | | | | X | + # plotters In 2.1.0 the option to use different plotters including compressed plotter was introduced. Each plotter has slightly different hardware requirements and may need slightly different options specified. The cli reference for all plotters can be found in the [Plotters CLI Page](/plotters-cli). Learn more about the alternative plotters in the [Alternative Plotters page](/plotting-software). @@ -162,7 +178,7 @@ For more detail, you can read about the DiskProver commands in [chiapos](https:/ The plots check challenge is a static challenge. For example if you run a plots check 20 times, with 30 tries against the same file, it will produce the same result every time. So while you may see a plot ratio \<< 1 for a plot check with `x` number of tries, it does not mean that the plot itself is worthless. It just means that given these static challenges, the plot is producing however many proofs. As the number of tries (`-n`) increases, we would expect the ratio to not be \<< 1. Since Mainnet is live, and given that the blockchain has new challenges with every signage point - just because a plot is having a bad time with one specific challenge, does not mean it has the same results versus another challenge. "Number of plots" and "k-size" are much more influential factors at winning blocks than "proofs produced per challenge". -**In theory**, a plot with a ratio >> 1 would be more likely to win challenges on the blockchain. Likewise, a plot with a ratio \<< 1 would be less likely to win. However, in practice, this isn't actually going to be noticeable. Therefore, don't worry if your plot check ratios are less than 1, unless they're _significantly_ less than 1 for _many_ `-n`. +**In theory**, a plot with a ratio >> 1 would be more likely to win challenges on the blockchain. Likewise, a plot with a ratio \<< 1 would be less likely to win. However, in practice, this isn't actually going to be noticeable. Therefore, don't worry if your plot check ratios are less than 1, unless they're _significantly_ less than 1 for _many_ `-n`. Likewise, a plot with a ratio \<< 1 would be less likely to win. However, in practice, this isn't actually going to be noticeable. Therefore, don't worry if your plot check ratios are less than 1, unless they're _significantly_ less than 1 for _many_ `-n`. # db @@ -193,16 +209,16 @@ Command: `chia db backup [add flags and parameters]` **Flags** -`--backup_file [PATH]`: (optional) Specifies the backup file and location. Default will create the backup in the same directory as the database. +`--backup_file [PATH]`: (optional) Specifies the backup file and location. Default will create the backup in the same directory as the database. Default will create the backup in the same directory as the database. `--no_indexes`: (optional) Create backup without indexes. **Database backup notes** -- This will vacuum (compress) and backup your database and may take several hours to complete. Use at your own leisure. +- This will vacuum (compress) and backup your database and may take several hours to complete. Use at your own leisure. Use at your own leisure. - You do not need to stop your Chia node while performing the upgrade. - The new database file will be written to the same folder as the original with "vacuumed\_" prepended to the name. -- To use the backup database: Close the chia client, remove/delete the main database, rename the backup database to remove "vacuumed\_", and restart the chia client. Note the initial start will take extra time as the client verifies the backup db file. +- To use the backup database: Close the chia client, remove/delete the main database, rename the backup database to remove "vacuumed\_", and restart the chia client. Note the initial start will take extra time as the client verifies the backup db file. Note the initial start will take extra time as the client verifies the backup db file. ## [validate](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/cmds/db.py) @@ -210,13 +226,13 @@ Command: `chia db validate [add flags and parameters]` **Flags** -`--db [PATH]`: (optional) Specifies which database file to validate. Default will use the default database and path. +`--db [PATH]`: (optional) Specifies which database file to validate. Default will use the default database and path. Default will use the default database and path. -`--validate-blocks`: (optional) Validate consistency of properties of the encoded blocks and block records. Note this will increase the validation time. +`--validate-blocks`: (optional) Validate consistency of properties of the encoded blocks and block records. Note this will increase the validation time. Note this will increase the validation time. **Database validate notes** -- This will validate your database and may take several hours to complete. Use at your own leisure. +- This will validate your database and may take several hours to complete. Use at your own leisure. Use at your own leisure. - You do not need to stop your Chia node while performing the upgrade. - This will start by processing the latest block and traverse to the first block. @@ -342,6 +358,7 @@ Options: Commands: completion Generate shell completion configure Modify configuration + dao Create, manage or show state of DAOs data Manage your data db Manage the blockchain database dev Developer commands and tools diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md index 4050333a87..5cc8e3fe18 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md @@ -25,12 +25,12 @@ Usage: `cic audit [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filepath | TEXT | False | The file path the dump the audit log | -| -d | --diff | TEXT | False | A previous audit log to diff against this one | -| -h | --help | None | False | Show a help message and exit | +| -f | --filepath | TEXT | False | The file path the dump the audit log | +| -d | --diff | TEXT | False | A previous audit log to diff against this one | +| -h | --help | None | False | Show a help message and exit |
Example @@ -102,12 +102,12 @@ Usage: `cic clawback [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | -| -h | --help | None | False | Show a help message and exit | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | +| -h | --help | None | False | Show a help message and exit |
Example @@ -134,11 +134,11 @@ Usage: `cic complete [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -h | --help | None | False | Show a help message and exit | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -h | --help | None | False | Show a help message and exit |
Example -- complete a withdrawal @@ -172,7 +172,7 @@ Usage: `cic derive_root [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:-------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------- | | -c | --configuration | TEXT | False | The configuration file with which to derive the root (or the filepath to create it at if using --db-path) [default: ./Configuration (needs derivation).txt] | | -db | --db-path | TEXT | False | Optionally specify a DB path to find the configuration from | | -pks | --pubkeys | TEXT | True | A comma separated list of pubkey files that will control this money | @@ -210,7 +210,7 @@ Usage: `cic examine_spend [OPTIONS] SPEND_FILE` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------------- | :------ | :------- | :--------------------------------------------------------------- | +|:------------- |:------------------ |:------- |:-------- |:---------------------------------------------------------------- | | | --qr-density | INTEGER | False | The amount of bytes to pack into a single QR code [default: 250] | | -va | --validate-against | TEXT | False | A new configuration file to check against requests for rekeys | | -h | --help | None | False | Show a help message and exit | @@ -249,12 +249,12 @@ Usage: `cic export_config [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :-------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---- |:-------- |:--------------------------------------------------------------------------------------------------------- | | -f | --filename | TEXT | False | The file path to export the config to (default: ./Configuration Export (\*\*\*\*\*\*).sqlite) | | -db | --db-path | TEXT | True | The file path to initialize/find the sync database at (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -p | --public | None | False | Enable to export the public information only (default: disabled) | -| -h | --help | None | False | Show a help message and exit | +| -p | --public | None | False | Enable to export the public information only (default: disabled) | +| -h | --help | None | False | Show a help message and exit |
Example -- export the config to export.bin @@ -283,12 +283,12 @@ Usage: `cic increase_security_level [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -h | --help | None | False | Show a help message and exit | +| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -h | --help | None | False | Show a help message and exit |
Example -- move to a 4-of-5 config @@ -318,7 +318,7 @@ Usage: `cic init [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------------- | :--- | :------- | :-------------------------------------------------------------------------------------------------- | +|:------------- |:--------------------- |:---- |:-------- |:--------------------------------------------------------------------------------------------------- | | -d | --directory | TEXT | False | The directory in which to create the configuration file [default: .] | | -wt | --withdrawal-timelock | TEXT | True | The amount of time where nothing has happened before a withdrawal can be made (in seconds) | | -pc | --payment-clawback | TEXT | True | The amount of time to clawback a payment before it's completed (in seconds) | @@ -354,15 +354,15 @@ Usage: `cic launch_singleton [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------- | -| -c | --configuration | TEXT | True | The configuration file with which to launch the singleton | -| -db | --db-path | TEXT | True | The file path to initialize the sync database at | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------- | +| -c | --configuration | TEXT | True | The configuration file with which to launch the singleton | +| -db | --db-path | TEXT | True | The file path to initialize the sync database at | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | -| | --fee | INTEGER | False | Fee to use for the launch transaction (in mojos) [default: 0] | -| -h | --help | None | False | Show a help message and exit | +| | --fee | INTEGER | False | Fee to use for the launch transaction (in mojos) [default: 0] | +| -h | --help | None | False | Show a help message and exit |
Example @@ -391,11 +391,11 @@ Usage: `cic p2_address [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -p | --prefix | TEXT | False | The prefix to use when encoding the address (default: xch) | -| -h | --help | None | False | Show a help message and exit | +| -p | --prefix | TEXT | False | The prefix to use when encoding the address (default: xch) | +| -h | --help | None | False | Show a help message and exit |
Example @@ -423,8 +423,8 @@ Usage: `cic payment [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------- | -| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | +|:------------- |:--------------------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------ | +| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | | -f | --filename | TEXT | False | The filepath to dump the spend bundle into | | -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | | -a | --amount | INTEGER | False | The outgoing amount (in mojos) to pay [default: 0] | @@ -463,14 +463,14 @@ Usage: `cic push_tx [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------- | -| -b | --spend-bundle | TEXT | True | The signed spend bundle | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------- | +| -b | --spend-bundle | TEXT | True | The signed spend bundle | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | -| -m | --fee | INTEGER | False | The fee to attach to this spend (in mojos) | -| -h | --help | None | False | Show a help message and exit | +| -m | --fee | INTEGER | False | The fee to attach to this spend (in mojos) | +| -h | --help | None | False | Show a help message and exit |
Example @@ -500,8 +500,8 @@ Usage: `cic show [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------------------ | -| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (**\*\***).sqlite) [required] | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------------------- | +| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (**\*\***).sqlite) [required] | | -c | --config | None | False | Enable to display the details of the public config (default: disabled) | | -d | --derivation | None | False | Enable to display the private details of the private config (default: disabled) | | -h | --help | None | False | Show a help message and exit | @@ -561,13 +561,13 @@ Usage: `cic start_rekey [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------ | :--- | :------- | :------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------------- |:---- |:-------- |:-------------------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | -| -new | --new-configuration | TEXT | True | The configuration you would like to rekey the singleton to | -| -h | --help | None | False | Show a help message and exit | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | +| -new | --new-configuration | TEXT | True | The configuration you would like to rekey the singleton to | +| -h | --help | None | False | Show a help message and exit |
Example @@ -596,13 +596,13 @@ Usage: `cic sync [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------ | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------- | | -c | --configuration | TEXT | False | The configuration file with which to initialize a sync database (default: ./Configuration (\*\*\*\*\*\*).txt) | | -db | --db-path | TEXT | True | The file path to initialize/find the sync database at (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | -| -s | --show | None | False | Enable to show a summary of the singleton after sync is complete (default: disabled) | -| -h | --help | None | False | Show a help message and exit | +| -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | +| -s | --show | None | False | Enable to show a summary of the singleton after sync is complete (default: disabled) | +| -h | --help | None | False | Show a help message and exit |
Example -- sync and show the config @@ -642,11 +642,11 @@ Usage: `cic update_config [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :--- | :------- | :------------------------------------------------------------------------------------------------------------ | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:---- |:-------- |:------------------------------------------------------------------------------------------------------------------------- | | -c | --configuration | TEXT | False | The configuration file with which to initialize a sync database (default: ./Configuration (\*\*\*\*\*\*).txt) | | -db | --db-path | TEXT | True | The file path to initialize/find the sync database at (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -h | --help | None | False | Show a help message and exit | +| -h | --help | None | False | Show a help message and exit |
Example -- update config after rekey @@ -676,7 +676,7 @@ Usage: `cic which_pubkeys [OPTIONS] AGGREGATE_PUBKEY` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :------------ | :------ | :------- | :------------------------------------------------------------------ | +|:------------- |:------------- |:------- |:-------- |:------------------------------------------------------------------- | | -pks | --pubkeys | TEXT | True | A comma separated list of pubkey files that may be in the aggregate | | -m | --num-pubkeys | INTEGER | False | Check only combinations of a specific number of pubkeys | | | --no-offset | None | False | Do not try the synthetic versions of the pubkeys | @@ -789,7 +789,7 @@ Positional arguments: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------- | :--- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:-------------------- |:---- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------- | | -y | --yes | None | False | Enable to skip confirmations (default: disabled) | | | --qr | None | False | Enable to show signature as QR code (default: disabled) | | | --nochunks | None | False | Enable to read the spend in its entirety rather than as chunks (testing only) argument to pass to gpg (besides -d). (default: disabled) | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md index dcc91e48a0..76245018ae 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md @@ -27,14 +27,14 @@ Usage: chia dao add \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -n | --name | TEXT | False | Set the DAO wallet name | -| -t | --treasury-id | TEXT | True | The Treasury ID of the DAO you want to track | -| -a | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -n | --name | TEXT | False | Set the DAO wallet name | +| -t | --treasury-id | TEXT | True | The Treasury ID of the DAO you want to track | +| -a | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | +| -h | --help | None | False | Show a help message and exit |
Example @@ -136,21 +136,21 @@ Usage: chia dao add_funds \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO Treasury Wallet | -| -w | --funding-wallet-id | INTEGER | True | The ID of the wallet to send funds from (must be of type `STANDARD_WALLET`) | -| -a | --amount | TEXT | True | The amount of funds to send, in XCH | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO Treasury Wallet | +| -w | --funding-wallet-id | INTEGER | True | The ID of the wallet to send funds from (must be of type `STANDARD_WALLET`) | +| -a | --amount | TEXT | True | The amount of funds to send, in XCH | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -251,12 +251,12 @@ Usage: chia dao balance \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -283,21 +283,21 @@ Usage: chia dao close_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | | -d | --self-destruct | None | False | If this flag is set, it will self-destruct a broken proposal, thus forcing to force it to close \[default: not set] | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | | | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | | | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -410,29 +410,29 @@ Usage: chia dao create \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -n | --name | TEXT | False | Set the DAO wallet name | -| | --proposal-timelock | INTEGER | False | The minimum number of blocks before a proposal can close \[default: 1000] | -| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing \[default: 20] | -| | --attendance-required | INTEGER | True | The minimum number of votes a proposal must receive to be accepted | -| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 \[default: 5000] | -| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed \[default: 10000] | -| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury \[default: 50] | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -n | --name | TEXT | False | Set the DAO wallet name | +| | --proposal-timelock | INTEGER | False | The minimum number of blocks before a proposal can close \[default: 1000] | +| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing \[default: 20] | +| | --attendance-required | INTEGER | True | The minimum number of votes a proposal must receive to be accepted | +| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 \[default: 5000] | +| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed \[default: 10000] | +| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury \[default: 50] | | | --proposal-minimum | INTEGER | False | The minimum amount (in xch) that a proposal must use to be created (this is a spam-prevention measure; it will be donated to the treasury when the proposal is closed) \[default: 0.000000000001] | -| | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | -| | --cat-amount | INTEGER | True | The number of DAO CATs (in mojos) to create when initializing the DAO | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --fee-for-cat | TEXT | False | Set the fees for the CAT creation transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | +| | --cat-amount | INTEGER | True | The number of DAO CATs (in mojos) to create when initializing the DAO | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --fee-for-cat | TEXT | False | Set the fees for the CAT creation transaction, in XCH \[default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | :::info @@ -563,22 +563,22 @@ Usage: chia dao create_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | -| -a | --amount | INTEGER | True | The amount of new cats the proposal will mint (in mojos) | -| -t | --to-address | TEXT | True | The address new cats will be minted to | -| -v | --vote-amount | INTEGER | True | The number of votes to add | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | +| -a | --amount | INTEGER | True | The amount of new cats the proposal will mint (in mojos) | +| -t | --to-address | TEXT | True | The address new cats will be minted to | +| -v | --vote-amount | INTEGER | True | The number of votes to add | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | :::warning @@ -682,24 +682,24 @@ Usage: chia dao create_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -t | --to-address | TEXT | False | The address the proposal will send funds to | -| -a | --amount | FLOAT | False | The amount of funds the proposal will send (in mojos) | -| -v | --vote-amount | INTEGER | True | The number of votes to add | -| | --asset-id | TEXT | False | The asset id of the funds the proposal will send. Leave blank for xch | -| -j | --from-json | TEXT | False | Path to a json file containing a list of additions, for use in proposals with multiple spends | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -t | --to-address | TEXT | False | The address the proposal will send funds to | +| -a | --amount | FLOAT | False | The amount of funds the proposal will send (in mojos) | +| -v | --vote-amount | INTEGER | True | The number of votes to add | +| | --asset-id | TEXT | False | The asset id of the funds the proposal will send. Leave blank for xch | +| -j | --from-json | TEXT | False | Path to a json file containing a list of additions, for use in proposals with multiple spends | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -818,26 +818,26 @@ Usage: chia dao create_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -v | --vote-amount | INTEGER | True | The number of votes to add | -| | --proposal-timelock | INTEGER | False | The new minimum number of blocks before a proposal can close | -| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing | -| | --attendance-required | INTEGER | False | The minimum number of votes a proposal must receive to be accepted | -| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | -| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed | -| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -v | --vote-amount | INTEGER | True | The number of votes to add | +| | --proposal-timelock | INTEGER | False | The new minimum number of blocks before a proposal can close | +| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing | +| | --attendance-required | INTEGER | False | The minimum number of votes a proposal must receive to be accepted | +| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | +| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed | +| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -908,19 +908,19 @@ Usage: chia dao exit_lockup \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet from which to exit the lockup | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet from which to exit the lockup | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | This command will unlock tokens that have been locked for voting, provided that there are no active proposals that these CATs have voted on. This command will automatically determine which CATs are available to be unlocked. @@ -1005,12 +1005,12 @@ Usage: chia dao get_id \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet which will receive the funds | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet which will receive the funds | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1039,13 +1039,13 @@ Usage: chia dao list_proposals \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -c | --include-closed | None | False | Set to include previously closed proposals \[Default: not set] | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -c | --include-closed | None | False | Set to include previously closed proposals \[Default: not set] | +| -h | --help | None | False | Show a help message and exit | This command will list all open proposals by default. If the `-c` flag is included, then all open _and_ closed proposals will be listed. @@ -1083,20 +1083,20 @@ Usage: chia dao lockup_coins \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | -| -a | --amount | TEXT | True | The amount of CATs (not mojos) to lock in voting mode | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | +| -a | --amount | TEXT | True | The amount of CATs (not mojos) to lock in voting mode | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | This command will lock the specified number of tokens, thereby making them available for voting. @@ -1215,19 +1215,19 @@ Usage: chia dao release_coins \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1308,12 +1308,12 @@ Usage: chia dao rules \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1346,13 +1346,13 @@ Usage: chia dao show_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -p | --proposal_id | TEXT | True | The ID of the proposal to fetch, obtainable by running the [list_proposals](#list_proposals) command | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :--------------------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -p | --proposal_id | TEXT | True | The ID of the proposal to fetch, obtainable by running the [list_proposals](#list_proposals) command | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1391,22 +1391,22 @@ Usage: chia dao vote \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | -| -a | --vote-amount | INTEGER | True | The number of votes you want to cast | -| -n | --vote-no | None | False | Use this option to vote against a proposal. If not present then the vote is for the proposal | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | +| -a | --vote-amount | INTEGER | True | The number of votes you want to cast | +| -n | --vote-no | None | False | Use this option to vote against a proposal. If not present then the vote is for the proposal | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md index 0e486762b7..db33a5c504 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md @@ -40,7 +40,7 @@ Usage: `chia data add_mirror [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:--------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------- | | -i | --id | TEXT | True | The hexadecimal ID of the store to mirror | | -a | --amount | INTEGER | True | The amount (in mojos) to spend to create the mirror. In theory, mirrors with a higher `amount` will be prioritized. Minimum `amount` is 0 | | -u | --url | TEXT | False | A URL where the mirror will reside. Can be repeated to add multiple URLs in the same command | @@ -76,15 +76,15 @@ Usage: `chia data add_missing_files [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------- | -| -i | --ids | TEXT | True | The hexadecimal store id(s) | -| -o | --override | None | False | If set, will overwrite files that already exist (default: not set) | -| -n | --no-override | None | False | If set, will not overwrite files that already exist (default: set) | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------- | +| -i | --ids | TEXT | True | The hexadecimal store id(s) | +| -o | --override | None | False | If set, will overwrite files that already exist (default: not set) | +| -n | --no-override | None | False | If set, will not overwrite files that already exist (default: set) | | -d | --directory | TEXT | False | If specified, use a non-default directory to write the files (default: `~/.chia/mainnet/data_layer/db/server_files_location_`) | -| -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Fingerprint of the wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | +| -f | --fingerprint | INTEGER | False | Fingerprint of the wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -158,18 +158,18 @@ Usage: `chia data clear_pending_roots [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -i | --id | TEXT | True | The ID of the store from which to clear the pending roots | -| | --yes | None | False | Set to confirm the action without prompting [Default: not set / prompt to confirm] | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -i | --id | TEXT | True | The ID of the store from which to clear the pending roots | +| | --yes | None | False | Set to confirm the action without prompting [Default: not set / prompt to confirm] | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example -To clear all pending roots, you need to enter the store ID. An example of this which also disables prompting: +To clear all pending roots, you need to enter the store ID. An example of this which also disables prompting: An example of this which also disables prompting: ```bash chia data clear_pending_roots -i 2772c8108e19f9fa98ff7bc7d4bafd821319bc90af6b610d086b85f4c21fa816 --yes @@ -201,13 +201,13 @@ Usage: `chia data create_data_store [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------: | :---------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:--------:|:------------------------------------------------------------------------------------------------------------- | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | -| | --verbose | None | False | Set to enable verbose output | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | +| | --verbose | None | False | Set to enable verbose output | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -352,13 +352,13 @@ Usage: `chia data delete_mirror [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -c | --coin_id | TEXT | True | The coin_id of the mirror to delete (obtainable from the [get_mirrors](#get_mirrors) command) | -| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -c | --coin_id | TEXT | True | The coin_id of the mirror to delete (obtainable from the [get_mirrors](#get_mirrors) command) | +| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -385,13 +385,23 @@ Usage: `chia data get_keys [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | -| -r | --root_hash | TEXT | False | The hexadecimal root hash | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | +| -r | --root_hash | TEXT | False | The hexadecimal root hash | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | +| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | +| -h | --help | None | False | Show a help message and exit | + +:::info + +Pagination is disabled by default. If it is enabled (by using the `page` flag), then the JSON response will include `total_pages` and `total_bytes`, in addition to the data. + +If an item is larger than `max-page-size`, an error will be thrown. + +:::
Example @@ -424,13 +434,23 @@ Usage: `chia data get_keys_values [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | -| -r | --root_hash | TEXT | False | The hexadecimal root hash | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | +| -r | --root_hash | TEXT | False | The hexadecimal root hash | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | +| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | +| -h | --help | None | False | Show a help message and exit | + +:::info + +Pagination is disabled by default. If it is enabled (by using the `page` flag), then the JSON response will include `total_pages` and `total_bytes`, in addition to the data. + +If an item is larger than `max-page-size`, an error will be thrown. + +:::
Example @@ -473,14 +493,24 @@ Usage: `chia data get_kv_diff [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store ID | -| -hash_1 | --hash_1 | TEXT | True | The first hash to compare | -| -hash_2 | --hash_2 | TEXT | True | The second hash to compare | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store ID | +| -hash_1 | --hash_1 | TEXT | True | The first hash to compare | +| -hash_2 | --hash_2 | TEXT | True | The second hash to compare | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | +| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | +| -h | --help | None | False | Show a help message and exit | + +:::info + +Pagination is disabled by default. If it is enabled (by using the `page` flag), then the JSON response will include `total_pages` and `total_bytes`, in addition to the data. + +If an item is larger than `max-page-size`, an error will be thrown. + +:::
Example @@ -522,7 +552,7 @@ Usage: `chia data get_mirrors [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | | -i | --id | TEXT | True | The hexadecimal ID of the store for which to get mirrors | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -568,7 +598,7 @@ Usage: `chia data get_owned_stores [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -h | --help | None | False | Show a help message and exit | @@ -598,6 +628,60 @@ Response: --- +### `get_proof` + +Functionality: Obtains a merkle proof of inclusion for a given key + +Usage: `chia data get_proof [OPTIONS]` + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | +| -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | +| -k | --key | TEXT | True | The hexadecimal key | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit | + +The proof is a proof of inclusion that a given key, value pair is in the specified datalayer store by chaining the Merkle hashes up to the published on-chain root hash. + +A user can generate a proof for multiple k,v pairs in the same datastore. + +
+Example + +```bash +chia data get_proof --id 7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e -k 0x0003 +``` + +Response: + +```bash +{ + "proof": { + "coin_id": "0x774e5f9ba7a8afbfa7fd2050347b4a2d400d3cd530637a18b61b094bb5a0f756", + "inner_puzzle_hash": "0x875cc80014bc72f2028c27500d5b44bf6906cd13ad16d7b5f4a5da77a06c8c2f", + "store_proofs": { + "proofs": [ + { + "key_clvm_hash": "0xa143e7ffd81147f136f921fef88760c46c7a05f15b81995f9c5cfed2a737a3f1", + "layers": [], + "node_hash": "0xe488fa1bf0f712b224df0daf312b3d479f80e3a330d4bebd8f26a0d52dc0ebbb", + "value_clvm_hash": "0xed052604ee4ff3996c15ef9b2cb0925233a2e78b6168bb6e67d133e074109b42" + } + ], + "store_id": "0x7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e" + } + }, + "success": true +} +``` + +
+ +--- + ### `get_root` Functionality: Get the Merkle Root and timestamp of a given store ID @@ -606,12 +690,12 @@ Usage: `chia data get_root [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -643,12 +727,12 @@ Usage: `chia data get_root_history [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -704,11 +788,11 @@ Usage: `chia data get_subscriptions [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -746,12 +830,12 @@ Usage: `chia data get_sync_status [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit | If the `root_hash` matches the `target_root_hash`, then the store is synced. @@ -788,14 +872,14 @@ Usage: `chia data get_value [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | -| -k | --key | TEXT | True | The hexadecimal key | -| -r | --root_hash | TEXT | False | The hexadecimal root hash | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | +| -k | --key | TEXT | True | The hexadecimal key | +| -r | --root_hash | TEXT | False | The hexadecimal root hash | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| | --help | None | False | Show a help message and exit |
Example @@ -828,7 +912,7 @@ Commands: `check` (Calls the plugin_info endpoint on all configured plugins) Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :--------------------------- | +|:------------- |:------------ |:---- |:-------- |:---------------------------- | | -h | --help | None | False | Show a help message and exit | Note that currently `check` is the only sub-command under the `plugins` command. This command is shown in the example. @@ -865,7 +949,7 @@ Usage: `chia data remove_subscription [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | | -store | --id | TEXT | True | The hexadecimal ID of the store to which you would like to subscribe | | -u | --url | TEXT | False | A URL where the data store resides. This argument can be used multiple times in the same command | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | @@ -898,7 +982,7 @@ Usage: `chia data subscribe [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | | -store | --id | TEXT | True | The hexadecimal ID of the store to which you would like to subscribe | | -u | --url | TEXT | False | A URL where the data store resides. This argument can be used multiple times in the same command | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | @@ -986,7 +1070,7 @@ Usage: `chia data unsubscribe [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | | -store | --id | TEXT | True | The hexadecimal ID of the store to which you would like to unsubscribe | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1031,12 +1115,14 @@ Usage: `chia data update_data_store [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | | -store | --id | TEXT | True | The hexadecimal store ID | | -d | --changelist | TEXT | True | A JSON object representing the changelist | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| | --submit | None | False | Set to submit the result on chain [Default: don't submit] | +| | --no-submit | None | False | Set to explicitly specify not to submit the result on chain [Default: don't submit] | | -h | --help | None | False | Show a help message and exit | A few notes on the `-d` / `--changelist` option: @@ -1221,6 +1307,73 @@ value = { --- +### `verify_proof` + +Functionality: Verifies a merkle proof of inclusion + +Usage: `chia data verify_proof [OPTIONS]` + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| -p | --proof | TEXT | True | Proof to validate in JSON format | +| -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit | + +Notes about this command: + +- It only needs to perform a single lookup of the on-chain root. +- It doesn't need to have synced any of the data, or be subscribed to the data store. +- To keep the proofs smaller, only the clvm hash of the key and value are included in the proof, and not the actual key or value. (A clvm hash is just a sha256 hash of the data prepended with 0x01.) +- Datalayer uses CLVM hashes for ease of verification in CLVM, although for this specific use case, there is no on-chain validation happening. +- When using this command, pay attention to the `current_root` value in the returned JSON. + - If `current_root` is `True`, this data chains to the current published root, and so if you synced the data, you can be sure it would be there. + - If `current_root` is `False`, the root has moved from the time the proof was generated. You cannot make any assumptions in this case about whether the data is in fact in the datastore or not since the root has changed, therefore the data might have changed. It is up to the caller to determine how to treat this case; one possible action would be to obtain a new proof. + +The proof to validate requires several fields: + +- `coin_id` +- `inner_puzzle_hash` +- `store_proofs` + - `proofs` + - `key_clvm_hash` + - `value_clvm_hash` + - `node_hash` + - `layers` + +Each of these fields is output with the [get_proof](#get_proof) command. For more examples, see chia-blockchain [PR #16845](https://github.com/Chia-Network/chia-blockchain/pull/16845). + +
+Example + +```bash +chia data verify_proof -p '{"coin_id": "0x774e5f9ba7a8afbfa7fd2050347b4a2d400d3cd530637a18b61b094bb5a0f756", "inner_puzzle_hash": "0x875cc80014bc72f2028c27500d5b44bf6906cd13ad16d7b5f4a5da77a06c8c2f", "store_proofs": {"proofs": [{"key_clvm_hash": "0xa143e7ffd81147f136f921fef88760c46c7a05f15b81995f9c5cfed2a737a3f1","layers": [], "node_hash": "0xe488fa1bf0f712b224df0daf312b3d479f80e3a330d4bebd8f26a0d52dc0ebbb", "value_clvm_hash": "0xed052604ee4ff3996c15ef9b2cb0925233a2e78b6168bb6e67d133e074109b42"}], "store_id": "0x7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e"}}' +``` + +Response: + +```bash +{ + "current_root": true, + "success": true, + "verified_clvm_hashes": { + "inclusions": [ + { + "key_clvm_hash": "0xa143e7ffd81147f136f921fef88760c46c7a05f15b81995f9c5cfed2a737a3f1", + "value_clvm_hash": "0xed052604ee4ff3996c15ef9b2cb0925233a2e78b6168bb6e67d133e074109b42" + } + ], + "store_id": "0x7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e" + } +} +``` + +
+ +--- + ### `wallet_log_in` Functionality: Request that the wallet service be logged in to the specified fingerprint @@ -1230,7 +1383,7 @@ Usage: `chia data wallet_log_in [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | +|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | True | Fingerprint of the wallet to use | | -h | --help | None | False | Show a help message and exit | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md index 352b5c260c..438376e431 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md @@ -20,7 +20,7 @@ Usage: chia wallet did create [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -n | --name | TEXT | False | Set the DID wallet name [default: None] | @@ -85,15 +85,15 @@ Usage: chia wallet did find_lost [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -id | --coin_id | TEXT | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | -| -m | --metadata | TEXT | False | The new whole metadata in json format | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -id | --coin_id | TEXT | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | +| -m | --metadata | TEXT | False | The new whole metadata in json format | | -r | --recovery_list_hash | TEXT | False | Override the recovery list hash of the DID. Only set this if your last DID spend updated the recovery list | -| -n | --num_verification | INTEGER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | -| -h | --help | None | False | Show a help message and exit. | +| -n | --num_verification | INTEGER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | +| -h | --help | None | False | Show a help message and exit. |
Example @@ -123,7 +123,7 @@ Usage: chia wallet did get_details [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | | -id | --coin_id | TEXT | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | @@ -170,7 +170,7 @@ Usage: chia wallet did get_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the wallet to use | @@ -205,7 +205,7 @@ Usage: chia wallet did message_spend [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :--------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:---------------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the wallet to use | @@ -254,7 +254,7 @@ Usage: chia wallet did get_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the wallet to use | @@ -323,7 +323,7 @@ Usage: chia wallet did sign_message [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --did_id | TEXT | True | DID ID you want to use for signing | @@ -358,7 +358,7 @@ Usage: chia wallet did transfer [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the DID wallet to transfer | @@ -435,7 +435,7 @@ Usage: chia wallet did update_metadata [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the DID wallet to use | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md index 9e659d3a53..26f3a28f4f 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md @@ -18,7 +18,7 @@ Usage: chia wallet nft create [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -di | --did-id | TEXT | False | DID Id to use | @@ -113,7 +113,7 @@ Usage: chia wallet nft mint [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -309,7 +309,7 @@ Usage: chia wallet nft set_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -346,7 +346,7 @@ Usage: chia wallet nft sign_message [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --nft_id | TEXT | True | NFT ID you want to use for signing | @@ -478,7 +478,7 @@ Usage: chia wallet nft list [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -577,7 +577,7 @@ Usage: chia wallet nft get_info [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -ni | --nft-coin-id | TEXT | True | Id of the NFT coin for which to show info | @@ -634,7 +634,7 @@ Usage: chia wallet nft transfer [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -712,7 +712,7 @@ Usage: chia wallet nft add_uri [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :-------------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:--------------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -779,7 +779,7 @@ Usage: chia wallet nft set_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md index de8b2cde06..13eb85ca86 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md @@ -37,7 +37,7 @@ Usage: `chia wallet make_offer [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :-----------: | :---------------: | :-----: | :------: | :------------------------------------------------------------------------------------------------------- | +|:-------------:|:-----------------:|:-------:|:--------:|:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -o | --offer | TEXT | True | A wallet id to offer and the amount to offer (formatted like wallet_id:amount) | @@ -45,6 +45,7 @@ Options: | -p | --filepath | TEXT | True | The path to write the generated offer file to | | -m | --fee | TEXT | False | A fee to add to the offer when it gets taken | | | --reuse | None | False | Set this flag to reuse an existing address for the offer [Default: generate a new address] | +| | --override | None | False | Creates offer without checking for unusual values | | -h | --help | None | False | Show a help message and exit | --- @@ -58,7 +59,7 @@ Usage: `chia wallet take_offer [OPTIONS] PATH_OR_HEX` Options: | Short Command | Long Command | Type | Required | Description | -| :-----------: | :---------------: | :-----: | :------: | :------------------------------------------------------------------------------------------------------- | +|:-------------:|:-----------------:|:-------:|:--------:|:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -e | --examine-only | None | False | Print the summary of the offer file but do not take it | @@ -77,7 +78,7 @@ Usage: `chia wallet cancel_offer [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :-----------: | :---------------: | :-----: | :------: | :----------------------------------------------------------------------------------------------------------------------- | +|:-------------:|:-----------------:|:-------:|:--------:|:------------------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -id | --id | TEXT | True | The offer ID that you wish to cancel | @@ -96,7 +97,7 @@ Usage: `chia wallet get_offers [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :-----------: | :--------------------: | :-----: | :------: | :------------------------------------------------------------------------------------------------------- | +|:-------------:|:----------------------:|:-------:|:--------:|:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -id | --id | TEXT | False | The ID of the offer that you wish to examine | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md index 25afb9cc67..d50c1a8bf0 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md @@ -19,30 +19,28 @@ Usage: chia plotters chiapos [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------ | :------ | :------- | :---------------------------------------------------------------------------------------- | -| -t | --tmp_dir | TEXT | True | Temporary directory 1 (where most of the plots temp data will be stored) | -| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | -| -k | --size | INTEGER | False | K value [Default: 32] | -| -m | --memo | TEXT | False | Memo variable | -| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | -| -b | --buffer | INTEGER | False | Size of the buffer, in MB [Default: 4608] | -| -u | --buckets | INTEGER | False | Number of buckets [Default: 64] | -| -s | --stripes | INTEGER | False | Stripe size [Default: 65536] | -| -r | --threads | INTEGER | False | Num threads [Default: 2] | -| -e | --nobitfield | None | False | Disable bitfield [Default: bitfield is enabled] | -| | --override-k | None | False | Force size smaller than 32 (only needed where `-k` is less than 32 [Default: disabled] | -| -a | --alt_fingerprint | INTEGER | False | Enter the alternative fingerprint of the key you want to use | -| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | -| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | -| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | -| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:--------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------- | +| -t | --tmp_dir | TEXT | True | Temporary directory 1 (where most of the plots temp data will be stored) | +| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | +| -k | --size | INTEGER | False | K value [Default: 32] | +| -m | --memo | TEXT | False | Memo variable | +| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | +| -b | --buffer | INTEGER | False | Size of the buffer, in MB [Default: 4608] | +| -u | --buckets | INTEGER | False | Number of buckets [Default: 64] | +| -s | --stripes | INTEGER | False | Stripe size [Default: 65536] | +| -r | --threads | INTEGER | False | Num threads [Default: 2] | +| -e | --nobitfield | None | False | Disable bitfield [Default: bitfield is enabled] | +| | --override-k | None | False | Force size smaller than 32 (only needed where `-k` is less than 32 [Default: disabled] | +| -a | --alt_fingerprint | INTEGER | False | Enter the alternative fingerprint of the key you want to use | +| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | +| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | +| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | +| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -x | --exclude_final_dir | None | False | Skips adding [final dir] to harvester for farming [Default: copy to final dir is enabled] | -| -d | --final_dir | TEXT | True | Final directory after plot has been created | -| | --compress | INTEGER | False | Compression level [Default: 0 (not compressed)] | -| -h | --help | None | False | Show a help message and exit | - ---- +| -d | --final_dir | TEXT | True | Final directory after plot has been created | +| | --compress | INTEGER | False | Compression level [Default: 0 (not compressed)] | +| -h | --help | None | False | Show a help message and exit | ### `madmax` @@ -53,7 +51,7 @@ Usage: chia plotters madmax [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :------------ | :------ | :------- | :--------------------------------------------------------------------------------------- | +|:------------- |:------------- |:------- |:-------- |:---------------------------------------------------------------------------------------- | | -k | --size | INTEGER | False | K value [Default: 32] | | -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -r | --threads | INTEGER | False | Num threads [Default: 4] | @@ -86,33 +84,33 @@ Usage: chia plotters bladebit cudaplot [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------- | -| -r | --threads | INTEGER | False | Num threads [Default: 12] | -| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | -| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | -| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | -| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | -| -t | --tmp_dir | TEXT | False | Temporary directory 1 (where most of the plot's temp data will be stored) [Default: in memory] | -| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | -| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | -| -w | --warmstart | None | False | Set to enable warm start [Default: disabled] | -| | --nonuma | None | False | Set to disable numa [Default: enabled] | -| | --no-cpu-affinity | None | False | Set to disable assigning automatic thread affinity [Default: enabled] | -| -v | --verbose | None | False | Set to enable verbose output [Default: disabled] | -| -d | --final_dir | TEXT | True | Final directory after plot has been created | -| | --compress | INTEGER | False | Compression level, 0-9 are accepted [Default: 1] | -| | --device | INTEGER | False | The CUDA device index (typically 0 or 1), set if more than one GPU is installed [Default: 0] | -| | --disk-128 | None | False | Enable hybrid disk plotting, requires 128 GB of system RAM [Default: disabled] | -| | --disk-16\* | None | False | Enable hybrid disk plotting, requires at least 16 GB of system RAM [Default: disabled] **\*SEE WARNING BELOW** | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | +| -r | --threads | INTEGER | False | Num threads [Default: 12] | +| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | +| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | +| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | +| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | +| -t | --tmp_dir | TEXT | False | Temporary directory 1 (where most of the plot's temp data will be stored) [Default: in memory] | +| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | +| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | +| -w | --warmstart | None | False | Set to enable warm start [Default: disabled] | +| | --nonuma | None | False | Set to disable numa [Default: enabled] | +| | --no-cpu-affinity | None | False | Set to disable assigning automatic thread affinity [Default: enabled] | +| -v | --verbose | None | False | Set to enable verbose output [Default: disabled] | +| -d | --final_dir | TEXT | True | Final directory after plot has been created | +| | --compress | INTEGER | False | Compression level, 0-9 are accepted [Default: 1] | +| | --device | INTEGER | False | The CUDA device index (typically 0 or 1), set if more than one GPU is installed [Default: 0] | +| | --disk-128 | None | False | Enable hybrid disk plotting, requires 128 GB of system RAM [Default: disabled] | +| | --disk-16\* | None | False | Enable hybrid disk plotting, requires at least 16 GB of system RAM [Default: disabled] **\*SEE WARNING BELOW** | +| -h | --help | None | False | Show a help message and exit | :::warning warning A few notes about the `disk-16` option: - As of BladeBit 3.0.1 (Chia 2.1.0), `disk-16` is experimental. -- This option has been disabled in the Chia 2.1.0 release. It is currently only available from the [standalone version](https://github.com/Chia-Network/bladebit/) of BladeBit. +- This option has been disabled in the Chia 2.1.0 release. This option has been disabled in the Chia 2.1.0 release. It is currently only available from the [standalone version](https://github.com/Chia-Network/bladebit/) of BladeBit. - Plots created with this option on Linux with direct I/O disabled appear to work, but more testing is still needed. - Plots created with this option on Windows are more likely to encounter issues. - Be sure to check all plots created with this option, as they could be invalid even if the plotter appeared to succeed. @@ -121,16 +119,14 @@ A few notes about the `disk-16` option: :::info -Computers with at least 256 GB of system memory should not use either the `disk-128` or `disk-16` options. They should also not use `tmp_dir` or `tmp_dir2`. In this case, plotting will be performed entirely in memory. +Computers with at least 256 GB of system memory should not use either the `disk-128` or `disk-16` options. They should also not use `tmp_dir` or `tmp_dir2`. In this case, plotting will be performed entirely in memory. They should also not use `tmp_dir` or `tmp_dir2`. In this case, plotting will be performed entirely in memory. -Computers with at least 128 GB of system memory (but less than 256 GB) should use the `disk-128`, `tmp_dir`, and `tmp_dir2` options. In this case, most of the plotting will be done in memory, and some will be done on disk. +Computers with at least 128 GB of system memory (but less than 256 GB) should use the `disk-128`, `tmp_dir`, and `tmp_dir2` options. In this case, most of the plotting will be done in memory, and some will be done on disk. In this case, most of the plotting will be done in memory, and some will be done on disk. -Linux computers with at least 16 GB of system memory (but less than 128 GB) can use the `disk-16`, `tmp_dir`, and `tmp_dir2` options. However, **do so at your own risk**. (See the above warning for details.) In this case, as much of the plotting as possible will be done in memory, and the rest will be done on disk. +Linux computers with at least 16 GB of system memory (but less than 128 GB) can use the `disk-16`, `tmp_dir`, and `tmp_dir2` options. However, **do so at your own risk**. (See the above warning for details.) In this case, as much of the plotting as possible will be done in memory, and the rest will be done on disk. However, **do so at your own risk**. (See the above warning for details.) In this case, as much of the plotting as possible will be done in memory, and the rest will be done on disk. ::: ---- - ### `ramplot` Functionality: Use the BladeBit RAM plotter @@ -140,7 +136,7 @@ Usage: chia plotters bladebit ramplot [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :--------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------- | | -r | --threads | INTEGER | False | Num threads [Default: 12] | | -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | @@ -155,8 +151,6 @@ Options: | | --compress | INTEGER | False | Compression level, 0-9 are accepted [Default: 1] | | -h | --help | None | False | Show a help message and exit | ---- - ### `diskplot` Functionality: Use the BladeBit disk plotter @@ -166,7 +160,7 @@ Usage: chia plotters bladebit diskplot [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------- | | -r | --threads | INTEGER | False | Num threads [Default: 12] | | -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | @@ -194,8 +188,6 @@ Options: | | --compress | INTEGER | False | Compression level, 0-9 are accepted [Default: 1] | | -h | --help | None | False | Show a help message and exit | ---- - ### `simulate` Functionality: Determine your farm's maximum capacity; this command is **only** avaible with the [standalone version](https://github.com/Chia-Network/bladebit/) of BladeBit. @@ -204,18 +196,94 @@ Usage: bladebit simulate [OPTIONS] \ Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--------- | :------- | :----------------------------------------------------------------------------- | -| -n | --iterations | INTEGER | False | The number of iterations to run [Default: 100] | -| -p | --parallel | INTEGER | False | The number of instances to run in parallel [Default: 1] | -| -l | --lookup | FLOAT | False | Maximum allowed time per proof lookup, in seconds [Default: 8.00] | -| -f | --filter | INTEGER | False | Plot filter bit count [Default: 512] | -| | --partials | INTEGER | False | Partials per-day simulation [Default: 300] | -| | --power | INTEGER | False | Time in seconds to run power simulation. -n is set automatically in this mode. | -| -s | --size | INTEGER | False | Size of farm. Only used when `--power` is set. | -| | --seed | HEX STRING | False | 64 char hex string to use as a random seed for challenges | -| | --no-cuda | None | False | If set, don't use CUDA for decompression. [Default: not set] | -| -d | --device | INTEGER | False | Cuda device index, to be used when more than one device exists [Default: 0] | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---------- |:-------- |:-------------------------------------------------------------------------------------------------------------------- | +| -n | --iterations | INTEGER | False | The number of iterations to run [Default: 100] | +| -p | --parallel | INTEGER | False | The number of instances to run in parallel [Default: 1] | +| -l | --lookup | FLOAT | False | Maximum allowed time per proof lookup, in seconds [Default: 8.00] | +| -f | --filter | INTEGER | False | Plot filter bit count [Default: 512] | +| | --partials | INTEGER | False | Partials per-day simulation [Default: 300] | +| | --power | INTEGER | False | Time in seconds to run power simulation. -n is set automatically in this mode. -n is set automatically in this mode. | +| -s | --size | INTEGER | False | Size of farm. Size of farm. Only used when `--power` is set. | +| | --seed | HEX STRING | False | 64 char hex string to use as a random seed for challenges | +| | --no-cuda | None | False | If set, don't use CUDA for decompression. \[Default: not set\] \[Default: not set\] | +| -d | --device | INTEGER | False | Cuda device index, to be used when more than one device exists [Default: 0] | +| -h | --help | None | False | Show a help message and exit | --- + +## `drplotter` + +Functionality: Use the DrPlotter plotter + +Usage: drplotter \[plot | verify\] \[OPTIONS\] + +### `plot` + +Functionality: Plot with the DrPlotter plotter + +Usage: drplotter plot [OPTIONS] + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:-------------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| -h | --help | None | False | Show a help message and exit | +| -f | --farmerkey | TEXT | True | Farmer Public Key (48 bytes, hex encoded) | +| -c | --contractkey | TEXT | True | Pool Contract Address (64 chars, hex encoded) | +| -d | --outputDirectory | TEXT | True | Final directory after plot has been created | +| | --compression | TEXT | False | Set compression mode. Choose between eco3x (68 bits per proof), or pro4x (49 bits per proof) [Default: eco3x] | +| -i | --gpu_id | INTEGER | False | GPU ID to use [Default: 0] | +| -n | --n_to_plot | INTEGER | False | Number of plots to create [Default: 0, fills directory] | +| -L | --gpu_memory_limit | INTEGER | False | GPU memory limit in MB [Default: 0 (disabled)] | +| | --min_gpu_ram | None | False | Use min gpu ram | + +### `verify` + +Functionality: Verify plots with the DrPlotter plotter + +Usage: drplotter verify [OPTIONS] + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:---- |:-------- |:---------------------------- | +| -h | --help | None | False | Show a help message and exit | +| -f | --file | TEXT | False | File to read from | +| -d | --directory | TEXT | False | Check all files in directory | + +--- + +## `drsolver` + +Functionality: Use the DrSolver harvester + +Usage: drsolver [OPTIONS] + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:---------------- |:------- |:-------- |:---------------------------------------------------- | +| -h | --help | None | False | Show a help message and exit | +| -g | --gpu | INTEGER | True | GPU ID to use for solving | +| -v | --verbose | None | False | Verbose output | +| -t | --token | TEXT | True | Client token to use for registration | +| | --generate-token | None | False | Generate a client token | +| | --drserver-ip | TEXT | True | Your own DrServer, at IP:PORT, e.g. 192.168.0.1:8080 | +| | --ssl | BOOLEAN | False | Use SSL for your solver server [Default: false] | + +--- + +## `drserver` + +Functionality: Use the DrServer harvester + +Usage: drserver [OPTIONS] + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:------- |:-------- |:---------------------------- | +| -h | --help | None | False | Show a help message and exit | +| -p | --port | INTEGER | True | Server port | +| -t | --token | TEXT | True | Server token | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md index 21dfff1d95..9347dc37b0 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md @@ -31,7 +31,7 @@ Usage: `chia dev sim create [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :--------------- | :------ | :------- | :---------------------------------------------------------------------------- | +|:------------- |:---------------- |:------- |:-------- |:----------------------------------------------------------------------------- | | -f | --fingerprint | INTEGER | False | Use your fingerprint to skip the key prompt | | -r | --reward_address | TEXT | False | Use this address instead of the default farming address | | -p | --plot-directory | TEXT | False | Set the directory in which to create/store plots (Default: 'simulator/plots') | @@ -305,7 +305,7 @@ Usage: `chia dev sim autofarm [OPTIONS] [on|off]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :--------------------------- | +|:------------- |:------------ |:---- |:-------- |:---------------------------- | | -h | --help | None | False | Show a help message and exit | Auto farming is enabled by default. The examples will show you how to disable/enable it. @@ -355,7 +355,7 @@ Usage: `chia dev sim farm [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------ | | -b | --blocks | INTEGER | False | Number of blocks to create (Default: 1) | | -n | --non-transaction | None | False | Enable to allow non-transaction blocks (Default: disabled) | | -a | --target-address | TEXT | False | Block reward address. If not specified, the default address will be used | @@ -490,7 +490,7 @@ Usage: `chia dev sim revert [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :--------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:---------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -b | --blocks | INTEGER | False | Number of blocks to go back (Default: 1) | | -n | --new_blocks | INTEGER | False | Number of new blocks to add during a reorg (Default: 1) | | -r | --reset | None | False | Enable to revert all transactions to the genesis block (Default: disabled) | @@ -563,7 +563,7 @@ Usage: `chia dev sim start [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :----------------------------------------------------- | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------ | | -r | --restart | None | False | Enable to restart running services (Default: disabled) | | -w | --wallet | None | False | Enable to start wallet (Default: disabled) | | -h | --help | None | False | Show a help message and exit | @@ -619,7 +619,7 @@ Usage: `chia dev sim status [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------- | | -f | --fingerprint | INTEGER | False | Get detailed information on this fingerprint. | | -k | --show_key | None | False | Enable to show detailed key information, including seed phrase (Default: disabled) | | -c | --show_coins | None | False | Enable to show all unspent coins (Default: disabled). When enabled, this does not show reward coins unless used in conjunction with `-i` | @@ -841,7 +841,7 @@ Usage: `chia dev sim stop [OPTIONS]` Options: Stop running services | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :-------------------------------------------- | +|:------------- |:------------ |:---- |:-------- |:--------------------------------------------- | | -d | --daemon | None | False | Enable to stop the daemon (Default: disabled) | | -w | --wallet | None | False | Enable to stop the wallet (Default: disabled) | | -h | --help | None | False | Show a help message and exit | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md index ba131ee7e3..4bdd6b69da 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md @@ -20,10 +20,10 @@ Usage: chia wallet vcs add_proof_reveal [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -p | --proof | TEXT | True\* | A flag to add as a proof | +| -p | --proof | TEXT | True\* | A flag to add as a proof | | -r | --root-only | None | False | If this flag is set, do not add the proofs to the DB, just output the root from the specified proofs [Default: not set] | | -h | --help | None | False | Show a help message and exit | @@ -72,7 +72,7 @@ Usage: chia wallet vcs get [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | | -s | --start | INTEGER | False | The index to start the list at [default: 0] | @@ -109,7 +109,7 @@ Usage: chia wallet vcs get_proofs_for_root [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | | -r | --proof-hash | TEXT | True | The root to search for | @@ -146,19 +146,19 @@ Usage: chia wallet vcs mint [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use as the issuing wallet | -| -d | --did | TEXT | True | The DID of the VC's proof provider. Must be owned by the issuing wallet | -| -t | --target-address | TEXT | False | The address to send the VC to once it's minted [Default: send to minting wallet] | -| -m | --fee | TEXT | False | Blockchain fee for mint transaction, in XCH | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use as the issuing wallet | +| -d | --did | TEXT | True | The DID of the VC's proof provider. Must be owned by the issuing wallet Must be owned by the issuing wallet | +| -t | --target-address | TEXT | False | The address to send the VC to once it's minted [Default: send to minting wallet] | +| -m | --fee | TEXT | False | Blockchain fee for mint transaction, in XCH | +| -h | --help | None | False | Show a help message and exit |
Example -A DID is required in order to mint a new VC. If the proof provider does not already have a DID, use the `did create` command to create one. For example: +A DID is required in order to mint a new VC. A DID is required in order to mint a new VC. If the proof provider does not already have a DID, use the `did create` command to create one. For example: For example: ```bash chia wallet did create -f 2108245669 -n Provider_DID -m 0.0001 @@ -171,7 +171,7 @@ Successfully created a DID wallet with name Provider_DID and id 2 on key 2108245 Successfully created a DID did:chia:1n2s77g7rer2v62xzrvd0at6tgx8m4g8t6encghs375r64lc6e5mssdkap3 in the newly created DID wallet ``` -Next, mint a new VC. Note that the DID specified with `-d` must be owned by the fingerprint specified with `-f` (or the one selected if `-f` is not used). For example: +Next, mint a new VC. Next, mint a new VC. Note that the DID specified with `-d` must be owned by the fingerprint specified with `-f` (or the one selected if `-f` is not used). For example: For example: ```bash chia wallet vcs mint -f 2108245669 -d did:chia:1n2s77g7rer2v62xzrvd0at6tgx8m4g8t6encghs375r64lc6e5mssdkap3 -m 0.0001 @@ -208,7 +208,7 @@ Inner Address: txch1at35qwx6djmadnh9v77a72z8vcaxsle36ke3dj26gcpt2fnh654qsqecnj It is recommended that you save the `Launcher ID` because it will be needed if the VC needs to be revoked later. -No proofs have been added yet. This is accomplished with the [update_proofs](#update_proofs) command. +No proofs have been added yet. No proofs have been added yet. This is accomplished with the [update_proofs](#update_proofs) command.
@@ -222,21 +222,21 @@ Usage: chia wallet vcs revoke [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :--------------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -p | --parent-coin-id | TEXT | True\* | The ID of the parent coin of the VC (\*optional if VC ID is used) | -| -l | --vc-id TEXT | TEXT | True\* | The launcher ID of the VC to revoke (must be tracked by wallet) (\*optional if Parent ID is used) | -| -m | --fee | TEXT | False | Blockchain fee for revocation transaction, in XCH | -| | --reuse-puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from (ignored if `--generate-new-puzhash` is also specified) [Default: generate new puzzle hash] | -| | --generate-new-puzhash | None | False | If this flag is set, then send the VC to a new puzzle hash. This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -p | --parent-coin-id | TEXT | True\* | The ID of the parent coin of the VC (\*optional if VC ID is used) | +| -l | --vc-id TEXT | TEXT | True\* | The launcher ID of the VC to revoke (must be tracked by wallet) (\*optional if Parent ID is used) | +| -m | --fee | TEXT | False | Blockchain fee for revocation transaction, in XCH | +| | --reuse-puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from (ignored if `--generate-new-puzhash` is also specified) [Default: generate new puzzle hash] | +| | --generate-new-puzhash | None | False | If this flag is set, then send the VC to a new puzzle hash. This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set | +| -h | --help | None | False | Show a help message and exit |
Example -Revoke the proofs from a VC. A few notes: +Revoke the proofs from a VC. A few notes: A few notes: - The only wallet authorized to call this command is the wallet that contains the DID that created the VC @@ -248,19 +248,20 @@ Response: ```bash VC successfully revoked! +Proofs successfully updated! Relevant TX records: -Transaction 286cc31575aa167c4b34cbc0a768a162caefb6afea77560db0693934ac3fbf1e +Transaction 76f5ea8475d695e798518cd405070dc22542e31fc85220ff7d2ca7b44852a45b Status: Pending -Amount sent: 1E-12 XCH -To address: txch1ehkl33dypc7mg820c7j94zfg8pz5j5lqtx7253nmxft52ryvzw8stx7czc -Created at: 2023-06-23 13:33:50 +Amount sent: 0 XCH +To address: txch10xjm79zct87gc8ux5vzrhnnt03zjn4ntn5y95w37rsfmp4rxjycquqctuc +Created at: 2023-06-15 10:15:27 -Transaction ae6378e84742ab6abb07df666291093938ec9e06ae8e2b4066d7386d94289ba3 +Transaction f9eebb0520d024aaf4ae176d554c0f806b8d724d21d5da03b5f541fafd69c99f Status: Pending -Amount sent: 0 XCH -To address: txch1mahlm65l8q9frcqcfveekx3a29cd74w6gfajqy05ukz2afrzg03syqkz3p -Created at: 2023-06-23 13:33:50 +Amount sent: 1E-12 XCH +To address: txch1dlyh9rwd9y6clt3pjjs3gh25ck9vlfx7qwqvvru27dmhgtn80z9s2rruam +Created at: 2023-06-15 10:15:28 ``` After the transactions have completed, the holder of the VC can now show that the VC does not contain any proofs: @@ -287,22 +288,22 @@ Usage: chia wallet vcs update_proofs [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :--------------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -l | --vc-id | TEXT | True | The launcher ID of the VC whose proofs should be updated | -| -t | --new-puzhash | TEXT | False | The puzzle hash to which to send the VC after the proofs have been updated | -| -p | --new-proof-hash | TEXT | True | The new proof hash to update the VC to | -| -m | --fee | TEXT | False | Blockchain fee for update transaction, in XCH | -| | --reuse-puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from (ignored if `--generate-new-puzhash` is also specified) [Default: generate new puzzle hash] | -| | --generate-new-puzhash | None | False | If this flag is set, then send the VC to a new puzzle hash. This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -l | --vc-id | TEXT | True | The launcher ID of the VC whose proofs should be updated | +| -t | --new-puzhash | TEXT | False | The puzzle hash to which to send the VC after the proofs have been updated | +| -p | --new-proof-hash | TEXT | True | The new proof hash to update the VC to | +| -m | --fee | TEXT | False | Blockchain fee for update transaction, in XCH | +| | --reuse-puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from (ignored if `--generate-new-puzhash` is also specified) [Default: generate new puzzle hash] | +| | --generate-new-puzhash | None | False | If this flag is set, then send the VC to a new puzzle hash. This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set | +| -h | --help | None | False | Show a help message and exit |
Example -Update the proofs. A few notes: +Update the proofs. A few notes: A few notes: - The only wallet authorized to call this command is the wallet that contains the DID that created the VC - The `-t` parameter must point to a puzzle hash, not an address diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md index 68426b2c3a..a39cbfd6b3 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md @@ -24,7 +24,7 @@ Usage: chia wallet add_token [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -id | --asset-id | TEXT | True | The Asset ID of the coin you wish to add/rename (the treehash of the TAIL program) | | -n | --token-name | TEXT | False | The name you wish to designate to the token | @@ -63,7 +63,7 @@ Usage: chia wallet coins list [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------- | +|:------------- |:------------------ |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------- | | -p | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | Id of the wallet to use [default: 1] | @@ -302,14 +302,14 @@ Coin ID: 0x1c51b470e3fc7f97e155fd72e464f2192426d35857d78777a2a9c08358252eeb ### `combine` -Functionality: Combine coins (typically used for combining dust). The maximum number of coins that can be combined within a single transaction is 500. +Functionality: Combine coins (typically used for combining dust). Functionality: Combine coins (typically used for combining dust). The maximum number of coins that can be combined within a single transaction is 500. Usage: chia wallet coins combine [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------ | | -p | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -801,7 +801,7 @@ Usage: chia wallet coins split [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -p | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -912,21 +912,21 @@ Usage: chia wallet delete_unconfirmed_transactions [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | -| -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -ids | --tx_ids | TEXT | True | IDs of the Clawback transactions you want to revert or claim. Separate multiple IDs by comma (,) | -| -m | --fee | TEXT | False | A fee to add to the offer when it gets taken, in XCH [default: 0] | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | +| -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -ids | --tx_ids | TEXT | True | IDs of the Clawback transactions you want to revert or claim. Separate multiple IDs by comma (,) Separate multiple IDs by comma (,) | +| -m | --fee | TEXT | False | A fee to add to the offer when it gets taken, in XCH [default: 0] | +| -h | --help | None | False | Show a help message and exit | Note that wallet will automatically detect whether the transactions should be reverted (clawed back) or claimed.
Example 1: clawback -First, create the clawback. This is a normal `send` command, with an extra `--clawback` timer: +First, create the clawback. First, create the clawback. This is a normal `send` command, with an extra `--clawback` timer: ```bash chia wallet send -f 4045726944 -a 1 -e "Sending 1 TXCH with 1-hour clawback" -m 0.0001 -t txch1pxam7zakgqfcfr0xm8xcemm76d637w6sg0l7j8h6gv7rdlf8cfxs326mze --clawback_time 3600 @@ -936,6 +936,7 @@ Response: ``` Submitting transaction... +Submitting transaction... Transaction submitted to nodes: [{'peer_id': 'b3d9de85d29931c10050b56c7afb91c99141943fc81ff2d1a8425e52be0d08ab', 'inclusion_status': 'SUCCESS', 'error_msg': None}] Run 'chia wallet get_transaction -f 4045726944 -tx 0x5a41dbe755a7a44b827b61cfa384e79bef5f79370f63fa7ffe1ea29212a26bf6' to get status ``` @@ -998,6 +999,7 @@ Response: ```bash Submitting transaction... +Submitting transaction... Transaction submitted to nodes: [{'peer_id': 'b3d9de85d29931c10050b56c7afb91c99141943fc81ff2d1a8425e52be0d08ab', 'inclusion_status': 'SUCCESS', 'error_msg': None}] Run 'chia wallet get_transaction -f 4045726944 -tx 0x3ca82042aba188d47a80b663523847fa6050a21e04647c7b31ad3aa9d8d5450f' to get status ``` @@ -1060,7 +1062,7 @@ Usage: chia wallet delete_unconfirmed_transactions [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1092,7 +1094,7 @@ Usage: chia wallet get_address [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1128,7 +1130,7 @@ Usage: chia wallet get_derivation_index [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -h | --help | None | False | Show a help message and exit | @@ -1159,7 +1161,7 @@ Usage: chia wallet get_transaction [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i, | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -1197,7 +1199,7 @@ Usage: chia wallet get_transactions [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------ | :------ | :------- | :---------------------------------------------------------------------------------------------------------------- | +|:------------- |:------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -1207,7 +1209,7 @@ Options: | | --paginate | None | False | Prompt for each page of data. Defaults to enabled for interactive consoles, otherwise defaults to disabled | | | --no-paginate | None | False | Do not prompt for each page of data. Defaults to disabled for interactive consoles, otherwise defaults to enabled | | | --sort-by-height | None | False | Sort transactions by height [default: disabled] | -| | --sort-by-relevance | None | False | Sort transactions by \{confirmed \| height \| time\} [default: disabled] | +| | --sort-by-relevance | None | False | Sort transactions by \{confirmed \| height \| time\} [default: disabled] | | | --reverse | None | False | Reverse the transaction ordering [default: disabled] | | | --clawback | None | False | Only show clawback transactions [default: disabled] | | -h | --help | None | False | Show a help message and exit | @@ -1353,6 +1355,8 @@ Status: Confirmed Amount received: 10 CAT aaee6b63bcbc4aef... To address: txch1stn20rhgmh5wvmyyfj2etdpdp73fla0ga4ymtsejz600dszf392s58kx2s Created at: 2022-12-14 00:40:39 +To address: txch1stn20rhgmh5wvmyyfj2etdpdp73fla0ga4ymtsejz600dszf392s58kx2s +Created at: 2022-12-14 00:40:39 ```
@@ -1372,7 +1376,7 @@ Usage: chia wallet notifications delete [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | TEXT | False | A specific notification ID to delete | @@ -1407,7 +1411,7 @@ Usage: chia wallet notifications get [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | TEXT | False | The specific notification ID to show | @@ -1449,7 +1453,7 @@ Usage: chia wallet notifications send [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -t | --to-address | TEXT | True | The address to send the notification to | @@ -1485,22 +1489,22 @@ Usage: chia wallet send [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | -| -a | --amount | TEXT | True | How much chia to send, in XCH | -| -e | --memo | TEXT | False | Additional memo for the transaction | -| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH [default: 0] | -| -t | --address | TEXT | True | Address to send the XCH | -| -o | --override | None | False | Submits transaction without checking for unusual values [default: disabled] | -| -ma | --min-coin-amount | TEXT | False | Ignore coins worth less then this much (XCH or CAT units) | -| -l | --max-coin-amount | TEXT | False | Ignore coins worth more then this much (XCH or CAT units) | -| | --exclude-coin | TEXT | False | Exclude this coin from being spent | -| | --reuse | None | False | Set this flag to reuse an existing address for the change [default: not set] | -| | --clawback_time | INTEGER | False | The seconds that the recipient needs to wait to claim the fund. A positive number will enable this feature | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | +| -a | --amount | TEXT | True | How much chia to send, in XCH | +| -e | --memo | TEXT | False | Additional memo for the transaction | +| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH [default: 0] | +| -t | --address | TEXT | True | Address to send the XCH | +| -o | --override | None | False | Submits transaction without checking for unusual values [default: disabled] | +| -ma | --min-coin-amount | TEXT | False | Ignore coins worth less then this much (XCH or CAT units) | +| -l | --max-coin-amount | TEXT | False | Ignore coins worth more then this much (XCH or CAT units) | +| | --exclude-coin | TEXT | False | Exclude this coin from being spent | +| | --reuse | None | False | Set this flag to reuse an existing address for the change [default: not set] | +| | --clawback_time | INTEGER | False | The seconds that the recipient needs to wait to claim the fund. A positive number will enable this feature A positive number will enable this feature | +| -h | --help | None | False | Show a help message and exit |
Example 1: send with memo @@ -1534,6 +1538,7 @@ Response: ``` Submitting transaction... +Submitting transaction... Transaction submitted to nodes: [{'peer_id': 'b3d9de85d29931c10050b56c7afb91c99141943fc81ff2d1a8425e52be0d08ab', 'inclusion_status': 'SUCCESS', 'error_msg': None}] Run 'chia wallet get_transaction -f 4045726944 -tx 0x3012893bf84b66c849f54b1c4bd893000188a7f728e439d3d6634048e8474482' to get status ``` @@ -1554,7 +1559,7 @@ To address: txch1pxam7zakgqfcfr0xm8xcemm76d637w6sg0l7j8h6gv7rdlf8cfxs326mze Created at: 2023-06-14 10:07:51 ``` -Note that the status is `Confirmed` even though it is a pending clawback transaction. This is because the original transaction _has_ been confirmed and a new pending clawback transaction has been created. +Note that the status is `Confirmed` even though it is a pending clawback transaction. Note that the status is `Confirmed` even though it is a pending clawback transaction. This is because the original transaction _has_ been confirmed and a new pending clawback transaction has been created. To view the pending clawback transaction, call `get_transactions` and include the `--clawback` flag (`-l 1` is used here to show only the latest transaction): @@ -1585,12 +1590,12 @@ Usage: chia wallet show [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| Short Command | Long Command | Type | Required | Description | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -w | --wallet_type | TEXT | False | Choose a specific wallet type to return, choose from the following: [standard_wallet \| atomic_swap \| authorized_payee \| multi_sig \| custody \| cat \| recoverable \| decentralized_id \| pooling_wallet \| nft \| data_layer \| data_layer_offer] | -| -h | --help | None | False | Show a help message and exit | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1649,7 +1654,7 @@ Usage: chia wallet sign_message [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -a | --address | TEXT | True | The address you want to use for signing | @@ -1684,7 +1689,7 @@ Usage: chia wallet update_derivation_index [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | +|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --index | INTEGER | True | Index to set. Must be greater than the current derivation index | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md index 744f65daca..95d23c163c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md @@ -12,17 +12,17 @@ We'll start with a brief description of CLVM. For details on the inner workings ## Comparison -| Design decision | EVM (Solidity) | CLVM (Chialisp) | -| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| The blockchain contains... | Smart contracts (compiled programs) as well as accounts. | The root hash of a binary tree, not source code. | -| Money | Smart contracts _contain_ money. | Standard Chia coins don't _contain_ money. They _are_ money. That said, more complex functionality is possible, allowing coins to contain state, such as money. | -| Determinism | Less deterministic because multiple people can execute code within the same contract. Depending on the order of execution, the result won't always be the same. | More deterministic because coins can only be spent once. However, it's possible to have a coin that multiple people can spend, which would reduce determinism. | -| Centralization | Multiple people interact with the same contract. Centralized by design. | Only the owner interacts with a smart coin. Decentralized by design. | -| Sandboxing | No sandboxing. If a contract is hacked, all users can lose their money. | Strong sandboxing. Spending is the only action allowed on an unspent coin, and only by the owner(s). If a coin is hacked, only that coin's owner(s) lose(s) their money. | +| Design decision | EVM (Solidity) | CLVM (Chialisp) | +| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| The blockchain contains... | Smart contracts (compiled programs) as well as accounts. | The root hash of a binary tree, not source code. | +| Money | Smart contracts _contain_ money. | Standard Chia coins don't _contain_ money. They _are_ money. That said, more complex functionality is possible, allowing coins to contain state, such as money. | +| Determinism | Less deterministic because multiple people can execute code within the same contract. Depending on the order of execution, the result won't always be the same. | More deterministic because coins can only be spent once. However, it's possible to have a coin that multiple people can spend, which would reduce determinism. | +| Centralization | Multiple people interact with the same contract. Centralized by design. | Only the owner interacts with a smart coin. Decentralized by design. | +| Sandboxing | No sandboxing. If a contract is hacked, all users can lose their money. | Strong sandboxing. Spending is the only action allowed on an unspent coin, and only by the owner(s). If a coin is hacked, only that coin's owner(s) lose(s) their money. | | Composability | Composition is supported, so it is possible to set rules temporarily governing how money may be spent. However, if money is moved outside of the contract, it will follow different rules.

(Note that it is possible to create a contract that “traps” ETH inside of it by only allowing money to be sent from the contract to specific types of addresses. However, by definition this limits the functionality of that money to whatever is contained within the contract.) | Composition is handled through inner puzzles. A puzzle's creator could say, “As long as these rules are followed, an inner puzzle can add any functionality.” Thus, it is possible to set rules that are intrinsic to the money itself, which must be followed _forever_. | -| MEV | Changing transaction order is both profitable and common. MEV is high. | Transactions all occur simultaneously in a block. MEV is low. | -| Reentrancy | Contracts can call functions on other contracts. Withdrawals can happen multiple times. Reentrancy is possible and must be carefully guarded against. | Coins interact with each other through announcements. They cannot call functions on other coins. Spends are atomic. Reentrancy is not possible. | -| Auditability/Security | Weak. Multiple points of failure. Numerous hacks prove this. | Strong. If an attacker changes a coin's puzzle, the hash also changes. The attacker is thus attempting to spend a coin that does not exist. The attacker can modify the solution, but the programmer can counter this by using assertions, which will make any such modifications fail. | +| MEV | Changing transaction order is both profitable and common. MEV is high. | Transactions all occur simultaneously in a block. MEV is low. | +| Reentrancy | Contracts can call functions on other contracts. Withdrawals can happen multiple times. Reentrancy is possible and must be carefully guarded against. | Coins interact with each other through announcements. They cannot call functions on other coins. Spends are atomic. Reentrancy is not possible. | +| Auditability/Security | Weak. Multiple points of failure. Numerous hacks prove this. | Strong. If an attacker changes a coin's puzzle, the hash also changes. The attacker is thus attempting to spend a coin that does not exist. The attacker can modify the solution, but the programmer can counter this by using assertions, which will make any such modifications fail. | --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/conditions.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/conditions.md index 5b974dcb8f..2103dfcf71 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/conditions.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/conditions.md @@ -13,24 +13,21 @@ There are two kinds of conditions. Some require something to be true (such as ti :::warning -Be vigilant when using `ASSERT_MY_COIN_ID` as a shortcut for validating the parent coin ID, puzzle hash, and amount. If they are passed into the solution separately, then validated all at once by hashing them together, it is possible to shift the bytes to the left or right and manipulate the values. +Be vigilant when using `ASSERT_MY_COIN_ID` as a shortcut for validating the parent coin ID, puzzle hash, and amount. If they are passed into the solution separately, then validated all at once by hashing them together, it is possible to shift the bytes to the left or right and manipulate the values. If they are passed into the solution separately, then validated all at once by hashing them together, it is possible to shift the bytes to the left or right and manipulate the values. -You are recommended to use the `coinid` operator when computing coin IDs. This operator was introduced with [CHIP-11](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md). It verifies that hashes are indeed 32 bytes in length, at no extra CLVM cost versus verifying the parent ID, puzzle hash, and amount individually. The `coinid` operator, as well as the other CHIP-11 operators, are described on the Chialisp [operators page](https://chialisp.com/operators#chip-0011-operators). +You are recommended to use the `coinid` operator when computing coin IDs. This operator was introduced with [CHIP-11](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md). It verifies that hashes are indeed 32 bytes in length, at no extra CLVM cost versus verifying the parent ID, puzzle hash, and amount individually. The `coinid` operator, as well as the other CHIP-11 operators, are described on the Chialisp [operators page](https://chialisp.com/operators#chip-0011-operators). This operator was introduced with [CHIP-11](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md). It verifies that hashes are indeed 32 bytes in length, at no extra CLVM cost versus verifying the parent ID, puzzle hash, and amount individually. The `coinid` operator, as well as the other CHIP-11 operators, are described on the Chialisp [operators page](https://chialisp.com/operators#chip-0011-operators). ::: :::warning -`ASSERT_COIN_ANNOUNCEMENT` and `ASSERT_PUZZLE_ANNOUNCEMENT` should typically only be used in a puzzle's _solution_, and not in the puzzle itself. This is especially important when using `ASSERT_COIN_ANNOUNCEMENT`, because it refers to a specific coin. +`ASSERT_COIN_ANNOUNCEMENT` and `ASSERT_PUZZLE_ANNOUNCEMENT` should typically only be used in a puzzle's _solution_, and not in the puzzle itself. This is especially important when using `ASSERT_COIN_ANNOUNCEMENT`, because it refers to a specific coin. This is especially important when using `ASSERT_COIN_ANNOUNCEMENT`, because it refers to a specific coin. -To illustrate the danger, let's say `coin A` uses this condition in its puzzle, and it asserts a coin announcement from `coin B`. -In this case, `coin A` requires `coin B` to be spent in the same block as it is spent. -If `coin B` is spent before `coin A`, then `coin A` can _never_ be spent. +To illustrate the danger, let's say `coin A` uses this condition in its puzzle, and it asserts a coin announcement from `coin B`. In this case, `coin A` requires `coin B` to be spent in the same block as it is spent. If `coin B` is spent before `coin A`, then `coin A` can _never_ be spent. However, if this condition is instead used in the _solution_ for `coin A`, and `coin B` has already been spent, then `coin A` can still be spent later, albeit with a different solution. -It is somewhat less dangerous to use `ASSERT_PUZZLE_ANNOUNCEMENT` in a coin's puzzle because it only relies on a coin with a specific puzzle, and many such coins might exist. -However, it is still best practice to only use this condition in a coin's solution. +It is somewhat less dangerous to use `ASSERT_PUZZLE_ANNOUNCEMENT` in a coin's puzzle because it only relies on a coin with a specific puzzle, and many such coins might exist. However, it is still best practice to only use this condition in a coin's solution. ::: @@ -49,10 +46,12 @@ This condition has no parameters. :::info This condition is part of [CHIP-0011](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md), and will be available at block height 5,496,000. ::: +::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(43 public_key message)` @@ -75,10 +74,12 @@ The following parameters are expected: :::info This condition is part of [CHIP-0011](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md), and will be available at block height 5,496,000. ::: +::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(44 public_key message)` @@ -101,10 +102,12 @@ The following parameters are expected: :::info This condition is part of [CHIP-0011](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md), and will be available at block height 5,496,000. ::: +::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(45 public_key message)` @@ -127,10 +130,12 @@ The following parameters are expected: :::info This condition is part of [CHIP-0011](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md), and will be available at block height 5,496,000. ::: +::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(46 public_key message)` @@ -154,10 +159,12 @@ The following parameters are expected: :::info This condition is part of [CHIP-0011](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md), and will be available at block height 5,496,000. ::: +::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(47 public_key message)` @@ -181,10 +188,12 @@ The following parameters are expected: :::info This condition is part of [CHIP-0011](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md), and will be available at block height 5,496,000. ::: +::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(48 public_key message)` @@ -208,10 +217,11 @@ The following parameters are expected: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(49 public_key message)` -Verifies a signature for a given message. For [security reasons](https://github.com/Chia-Network/post-mortem/blob/main/2023-05/2023-05-08-AGG_SIG_UNSAFE-can-mimic-AGG_SIG_ME-condition.md), domain strings are not permitted at the end of `AGG_SIG_UNSAFE` messages. +Verifies a signature for a given message. Verifies a signature for a given message. For [security reasons](https://github.com/Chia-Network/post-mortem/blob/main/2023-05/2023-05-08-AGG_SIG_UNSAFE-can-mimic-AGG_SIG_ME-condition.md), domain strings are not permitted at the end of `AGG_SIG_UNSAFE` messages. The following parameters are expected: @@ -225,12 +235,13 @@ The following parameters are expected: ### 50 `AGG_SIG_ME` {#agg-sig-me} :::tip -In most cases, `AGG_SIG_ME` is the recommended condition for requiring signatures. Signatures created for a specific coin spend will only be valid for that exact coin, which prevents an attacker from reusing the signature for other spends. +In most cases, `AGG_SIG_ME` is the recommended condition for requiring signatures. Signatures created for a specific coin spend will only be valid for that exact coin, which prevents an attacker from reusing the signature for other spends. ::: Signatures created for a specific coin spend will only be valid for that exact coin, which prevents an attacker from reusing the signature for other spends. ::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,200,000. ::: +::: Format: `(50 public_key message)` @@ -253,10 +264,11 @@ The following parameters are expected: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) of 1,800,000. ::: +::: Format: `(51 puzzle_hash amount (...memos)?)` -Creates a new coin output with a given puzzle hash and amount. This coin is its parent. +Creates a new coin output with a given puzzle hash and amount. This coin is its parent. This coin is its parent. For more information on the `memos` parameter, see the section on [Memos and Hinting](#memos). @@ -288,7 +300,7 @@ The following parameters are expected: Format: `(60 message)` -Creates an announcement of a given message, tied to this coin's id. For more details, see the section on [Announcements](#announcements). +Creates an announcement of a given message, tied to this coin's id. For more details, see the section on [Announcements](#announcements). For more details, see the section on [Announcements](#announcements). The following parameters are expected: @@ -302,7 +314,7 @@ The following parameters are expected: Format: `(61 announcement_id)` -Asserts an announcement with a given id, which is calculated as `sha256(coin_id + message)`. For more details, see the section on [Announcements](#announcements). +Asserts an announcement with a given id, which is calculated as `sha256(coin_id + message)`. For more details, see the section on [Announcements](#announcements). For more details, see the section on [Announcements](#announcements). The following parameters are expected: @@ -316,7 +328,7 @@ The following parameters are expected: Format: `(62 message)` -Creates an announcement of a given message, tied to this coin's puzzle hash. For more details, see the section on [Announcements](#announcements). +Creates an announcement of a given message, tied to this coin's puzzle hash. For more details, see the section on [Announcements](#announcements). For more details, see the section on [Announcements](#announcements). The following parameters are expected: @@ -330,7 +342,7 @@ The following parameters are expected: Format: `(63 announcement_id)` -Asserts an announcement with a given id, which is calculated as `sha256(puzzle_hash + message)`. For more details, see the section on [Announcements](#announcements). +Asserts an announcement with a given id, which is calculated as `sha256(puzzle_hash + message)`. For more details, see the section on [Announcements](#announcements). For more details, see the section on [Announcements](#announcements). The following parameters are expected: @@ -579,16 +591,18 @@ The following parameters are expected: :::info This condition is part of [CHIP-0011](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md), and will be available at block height 5,496,000. ::: +::: :::note This condition adds an additional [CLVM cost](/coin-set-costs/) equal to whatever the value of the first argument is. ::: +::: Format: `(90 cost ...args)` -Allows future conditions with non-zero CLVM costs to be added as soft forks. This functionality was previously only possible as a hard fork. +Allows future conditions with non-zero CLVM costs to be added as soft forks. This functionality was previously only possible as a hard fork. This functionality was previously only possible as a hard fork. -The cost of the condition is specified in ten-thousands, and further arguments are not specified (the soft-forked condition defines these). The reason to scale the cost by 10,000 is to make the argument smaller. For example, a cost of 100 in this condition would equate to an actual cost of 1 million (1,000,000). The cost argument is two bytes, with a maximum size of 65,535 (an actual cost of 655,350,000). +The cost of the condition is specified in ten-thousands, and further arguments are not specified (the soft-forked condition defines these). The cost of the condition is specified in ten-thousands, and further arguments are not specified (the soft-forked condition defines these). The reason to scale the cost by 10,000 is to make the argument smaller. For example, a cost of 100 in this condition would equate to an actual cost of 1 million (1,000,000). The cost argument is two bytes, with a maximum size of 65,535 (an actual cost of 655,350,000). For example, a cost of 100 in this condition would equate to an actual cost of 1 million (1,000,000). The cost argument is two bytes, with a maximum size of 65,535 (an actual cost of 655,350,000). The following parameters are expected: @@ -599,7 +613,7 @@ The following parameters are expected: ## Memos and Hinting {#memos} -When a coin uses one or more outer puzzles that change their puzzle hash, it's challenging for wallets to know which coins they have the ability to spend. The memos field allows you to hint the inner puzzle hash of created coins, which consequently lets the wallet know that the coin belongs to it. Coins can be looked up by the inner puzzle hash rather than the outer puzzle hash. +When a coin uses one or more outer puzzles that change their puzzle hash, it's challenging for wallets to know which coins they have the ability to spend. When a coin uses one or more outer puzzles that change their puzzle hash, it's challenging for wallets to know which coins they have the ability to spend. The memos field allows you to hint the inner puzzle hash of created coins, which consequently lets the wallet know that the coin belongs to it. Coins can be looked up by the inner puzzle hash rather than the outer puzzle hash. Coins can be looked up by the inner puzzle hash rather than the outer puzzle hash. The `CREATE_COIN` condition is defined as a list containing the opcode `51` and the following arguments: @@ -610,26 +624,26 @@ The `CREATE_COIN` condition is defined as a list containing the opcode `51` and The `memos` parameter is an optional list, which must be null terminated. -If `memos` is present, and the first memo is exactly 32 bytes long, it's used as the hint and the rest of the list are memos. Otherwise, values in the entire list are memos. +If `memos` is present, and the first memo is exactly 32 bytes long, it's used as the hint and the rest of the list are memos. Otherwise, values in the entire list are memos. Otherwise, values in the entire list are memos. As an example, the following inner solution for the [standard transaction](https://chialisp.com/standard-transactions) would create an unhinted coin: ```chialisp -(() (q . ((51 target_puzzle_hash amount))) ()) +(() (q . (() (q . ((51 target_puzzle_hash amount))) ()) ``` The following solution would instead create a coin with the hint matching the inner puzzle hash: ```chialisp -(() (q . ((51 target_puzzle_hash amount (target_puzzle_hash)))) ()) +(() (q . (() (q . ((51 target_puzzle_hash amount (target_puzzle_hash)))) ()) ``` This `CREATE_COIN` condition creates the same coin as before, but now it specifies the hint with which the receiving wallet can look up to find this coin. -Hints are only necessary for outer puzzles, of which the inner puzzle hash matches the hint. For example, coins using the standard transaction itself with no outer puzzle do not need a hint. +Hints are only necessary for outer puzzles, of which the inner puzzle hash matches the hint. Hints are only necessary for outer puzzles, of which the inner puzzle hash matches the hint. For example, coins using the standard transaction itself with no outer puzzle do not need a hint. ## Announcements Announcements are ephemeral, meaning that they don't last forever. They can only be asserted within the block they are created. Their purpose is to ensure multiple coins are spent together, either for fees, verification, or as a security measure. -For coin announcements, the id is the `coin_id` and `message` sha256 hashed together. Likewise, for puzzle announcements, it's the `puzzle_hash` and `message` sha256 hashed together. +For coin announcements, the id is the `coin_id` and `message` sha256 hashed together. For coin announcements, the id is the `coin_id` and `message` sha256 hashed together. Likewise, for puzzle announcements, it's the `puzzle_hash` and `message` sha256 hashed together. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md index 066d2a9d96..d24b24c341 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md @@ -3,7 +3,7 @@ title: Costs slug: /coin-set-costs --- -Cost is a unit of measurement that is used to represent the available space in a block. It is measured by the amount of computing power required to execute the programs within it, as well as the physical drive space required to store data on each node's machine. +Cost is a unit of measurement that represents resources expended to record a transaction in a block. Cost is a unit of measurement that is used to represent the available space in a block. It is measured by the amount of computing power required to execute the programs within it, as well as the physical drive space required to store data on each node's machine. :::info The maximum cost per block is 11,000,000,000 (11 billion), which is typically equivalent to around 400 KB of space. However, not every block is completely full. @@ -13,9 +13,9 @@ It is important to keep the cost usage of programs on the Chia blockchain as low ## Cost Calculation -Every CLVM program uses a certain amount of cost during execution, based on the operators and the values they are called on. You can refer to the [Cost page](https://chialisp.com/costs) on the Chialisp website to learn more about the cost of various CLVM operators. +Cost has several components. First, every CLVM program uses a certain amount of cost during execution, based on the operators and the values they are called on. You can refer to the [Cost page](https://chialisp.com/costs) on the Chialisp website to learn more about the cost of various CLVM operators. -Additionally, certain conditions in a coin spend have a cost associated with them as well. A few common examples are [`CREATE_COIN`](https://chialisp.com/conditions#create-coin) and [`AGG_SIG_ME`](/conditions#agg-sig-me), which are expensive operations. +Additionally, certain conditions in a coin spend have a cost associated with them as well. Additionally, certain conditions in a coin spend have a cost associated with them as well. A few common examples are [`CREATE_COIN`](https://chialisp.com/conditions#create-coin) and [`AGG_SIG_ME`](/conditions#agg-sig-me), which are expensive operations. Finally, each byte of data that gets added to the blockchain has a cost of 12,000. Spend bundles are created using a serialized format of CLVM programs, calculated by running [opc](https://chialisp.com/commands#serialize) on the original CLVM program. Each two-digit pair of this format is equivalent to one byte, which costs 12,000 to store on the blockchain. @@ -25,7 +25,7 @@ Aside from cost, the maximum number of atoms and pairs (counted separately) in a The minimum spec machine to run a full node is the Raspberry Pi 4. How do we know if this machine can stay synced? The worst case scenario occurs when multiple full transaction blocks are created with the minimum amount of time between them. This will temporarily put maximum load on the system. If the Pi can stay synced in this scenario, then it easily should be able to stay synced under normal load. -The first question we must answer is how much time elapses between transaction blocks. Chia's consensus mandates that at least three signage points must be reached before infusion_iterations may occur, so the minimum time between blocks is the following: +The first question we must answer is how much time elapses between transaction blocks. The first question we must answer is how much time elapses between transaction blocks. Chia's consensus mandates that at least three signage points must be reached before infusion_iterations may occur, so the minimum time between blocks is the following: ``` 3 signage points * signage point time @@ -137,3 +137,31 @@ Theoretical maximum cost per block: `3 620 074 957 + 3 620 074 957 + 3 620 074 9 The theoretical maximum size of a single block is `maximum cost per block / cost per byte`, or `11 000 000 000 / 12 000 = 916 667 bytes`. However, this number ignores the costs of all operators. If you want a CLVM program to do anything useful, the maximum size would be closer to 400 KB. Even this number is not realistic because it assumes that a single program will take up an entire block. The maximum number of vanilla transactions (with two outputs) per block is 1000. Therefore, if there is fee pressure on Chia's blockchain, a 400 KB program would need to include a larger fee than the top 1000 vanilla transactions in the mempool -- combined -- in order for a farmer to include it. + +### Estimated Transaction Costs + +The below chart contains costs for various transactions on the blockchain, each of these assumes the inputs and outputs have been optimized and represent a best case scenario. + +:::note +The [minimum effective](/mempool/#fee-required-for-inclusion) fee represents 5 x the clvm cost and is the minimum fee recognized by the default consensus rules (any fee less would be the same as 1 mojo). This means one needs to use at least the fees listed below during moderate fee pressure but greater fees might be needed for time sensitive transactions to process in a timely manner. + +Please note that the costs and fees listed are for vanilla versions of these transactions, they can vary based on the number of input and output coins needed so consider these the bare minimum. Transactions with a '\*' are listed with a fee of 3 x the minimum effective fee. This is to ensure the fees are more realistic for how coins are distributed in users wallets but note that vanilla versions of these would be 1/3 that which is listed. +::: + +| Transaction Type | clvm Cost | Minimum Effective Fee | +| --------------------------------- | ------------- | ----------------------------------- | +| **Full Block (with 50% cap)** | 5,500,000,000 | 27,500,000,000 mojo (0.0275 xch) | +| **Standard Transaction** | 6,000,000 | 90,000,000 mojo (0.00009 xch) \* | +| **PlotNFT Creation** | 18,000,000 | 90,000,000 mojo (0.00009 xch) | +| **Minting NFT with DID** | 123,000,000 | 615,000,000 mojo (0.000615 xch) | +| **Minting NFT without DID** | 53,000,000 | 265,000,000 mojo (0.000265 xch) | +| **Adding URI to NFT with DID** | 71,000,000 | 355,000,000 mojo (0.000355 xch) | +| **Adding URI to NFT without DID** | 41,000,000 | 205,000,000 mojo (0.000205 xch) | +| **Transfer NFT with DID** | 67,000,000 | 335,000,000 mojo (0.000335 xch) | +| **Assign DID to NFT** | 107,000,000 | 535,000,000 mojo (0.000535 xch) | +| **Send Clawback Transaction** | 10,000,000 | 150,000,000 mojo (0.00015 xch) \* | +| **Claim Clawback Transaction** | 1,400,000 | 7,000,000 mojo (.000007 xch) | +| **Clawback Clawback Transaction** | 15,600,000 | 75,800,000 mojo (.0000758 xch) | +| **Combine 500 Farming Rewards** | 3,100,000,000 | 15,500,000,000 mojo (.0155 xch) | +| **Split 1 Coin into 2** | 11,000,000 | 55,000,000 mojo (.000055 xch) | +| **Cat Transaction** | 37,000,000 | 555,000,000 mojo (.000555 xch) \* | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md index 1252d5259f..a163222fa7 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md @@ -79,7 +79,7 @@ Finally, the formula to calculate the minimum netspace percentage required for t The following table shows the minimum required proportion of the total netspace an attacker must have in order to succeed in a majority attack. This table is valid for attacks lasting any amount of time, though sometimes it's overly conservative for attacks lasting more than one epoch. It uses fixed values for the first two columns. | Number of Timelords | VA (relative to VH) | DD | SA | Percent of netspace required | Comment | -| :-----------------: | :-----------------: | :-----: | :---: | :--------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:-------------------:|:-------------------:|:-------:|:-----:|:----------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 0 | N/A | 1 | ∞ | N/A | Without a timelord, the attack is not possible. | | 1 | 0.5 | 1 | 2 | 66.7% | With a 0.5x timelord, the attacker must control twice as much space as the rest of the network combined. | | ∞ | 0.5 | 1.34313 | 1.489 | 59.8% | With infinite 0.5x timelords, the attacker gains a double-dip advantage, so less space is required versus having a single timelord of the same speed. | @@ -91,7 +91,7 @@ The following table shows the minimum required proportion of the total netspace For attacks lasting longer than one epoch, `DD` will not exceed 1.34313. In such an attack, the final row from the preceding table will change to the following: | Number of Timelords | VA (relative to VH) | DD | SA | Percent of netspace required | Comment | -| :-----------------: | :-----------------: | :-----: | :---: | :--------------------------: | :------------------------------------------------------------------------------- | +|:-------------------:|:-------------------:|:-------:|:-----:|:----------------------------:|:-------------------------------------------------------------------------------- | | ∞ | 2 | 1.34313 | 0.372 | 27.1% | If the attack longer than one epoch, the double-dip advantage will be minimized. | Note that if we continue to increase `VA`, `DD` will always remain at 1.4678 for the first table, and 1.34313 for the second table. The percent of netspace required will decrease linearly. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/challenges.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/challenges.md index a730515681..350d14a959 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/challenges.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/challenges.md @@ -45,9 +45,9 @@ In the networking protocol, the three VDF proofs are usually passed around toget ## Genesis Challenge -The genesis challenge is the first challenge on a network that uses the Proof of Space and Time consensus. The timelords use this challenge to calculate and broadcast the very first signage point. Chia's mainnet, testnets and simulated networks each have their own unique _genesis challenge_. +The genesis challenge is the first challenge on a network that uses the Proof of Space and Time consensus. The timelords use this challenge to calculate and broadcast the very first signage point. Chia's mainnet, testnets and simulated networks each have their own unique _genesis challenge_. The timelords use this challenge to calculate and broadcast the very first signage point. Chia's mainnet, testnets and simulated networks each have their own unique _genesis challenge_. -The genesis challenge is created arbitrarily, by hashing a preimage. In the case of Chia's mainnet, the preimage included the hash of Bitcoin block [675317](https://www.blockchain.com/explorer/blocks/btc/675317), which was mined shortly prior to the launch of Chia's network. It also included the following message from Bram: +The genesis challenge is created arbitrarily, by hashing a preimage. The genesis challenge is created arbitrarily, by hashing a preimage. In the case of Chia's mainnet, the preimage included the hash of Bitcoin block [675317](https://www.blockchain.com/explorer/blocks/btc/675317), which was mined shortly prior to the launch of Chia's network. It also included the following message from Bram: It also included the following message from Bram: `"Operational error causes Fed payment system to crash" We stand on the shoulders of giants, now let's get farming!` @@ -63,6 +63,6 @@ The SHA256 hash of this preimage is: ccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb ``` -This hash is the genesis challenge for Chia's mainnet. The complete JSON data for the genesis challenge is located [here](https://download.chia.net/notify/mainnet_alert.txt). The first block on Chia's mainnet ([block 0](https://www.spacescan.io/block/0)) was created at signage point `2`; it points to the genesis challenge as its previous block. The prefarm was then distributed in [block 1](https://www.spacescan.io/block/1), at signage point `7`. +This hash is the genesis challenge for Chia's mainnet. This hash is the genesis challenge for Chia's mainnet. The complete JSON data for the genesis challenge is located [here](https://download.chia.net/notify/mainnet_alert.txt). The first block on Chia's mainnet ([block 0](https://www.spacescan.io/block/0)) was created at signage point `2`; it points to the genesis challenge as its previous block. The prefarm was then distributed in [block 1](https://www.spacescan.io/block/1), at signage point `7`. The first block on Chia's mainnet ([block 0](https://www.spacescan.io/block/0)) was created at signage point `2`; it points to the genesis challenge as its previous block. The prefarm was then distributed in [block 1](https://www.spacescan.io/block/1), at signage point `7`. The genesis challenge for other networks can be found opening `config.yaml` (located in `~/.chia/mainnet/config` for Chia's mainnet and testnets) and searching for `GENESIS_CHALLENGE:` in the section corresponding to the desired network. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/consensus-intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/consensus-intro.md index 6ee2bb566e..d2a9e9fa78 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/consensus-intro.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/consensus-intro.md @@ -3,6 +3,12 @@ title: Consensus Introduction slug: /consensus-intro --- +:::info + +This section is meant to provide a high level overview of Chia's consensus. If you are interested in implementing a new full node, we recommend that you review the [source code](https://github.com/Chia-Network/chia-blockchain/tree/main/chia/consensus) in order to understand in depth how the consensus is implemented. If you have further questions, feel free to reach out to us on [Discord](https://discord.gg/chia). + +::: + Decentralized consensus algorithms require Sybil resistance, using a resource that is both cryptographically verifiable and scarce (not infinite). In previous blockchain systems, two different scarce resources have been used: computing power (Proof of Work) and staked money (Proof of Stake). Chia's Proof of Space and Time consensus uses storage capacity as the scarce resource. This comes much closer than previous systems to Satoshi's original ideal of "one CPU, one vote," where a _vote_ refers to a chance to win and validate a block, not an actual vote on-chain. For example, someone storing 500 GiB has 5 "votes," and someone storing 100 GiB has 1 "vote." diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/foliage.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/foliage.md index bee6ae458e..7bf98d4214 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/foliage.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/foliage.md @@ -3,21 +3,31 @@ title: Foliage slug: /consensus-foliage --- -In the previous diagrams, there is no place for farmers to specify their rewards, since all blocks are canonical. There is also no place to include transactions. Everything we have talked about so far is the trunk of the blockchain. +In the previous diagrams, there is no place for farmers to specify their rewards, since all blocks are canonical. There is also no place to include transactions. Everything we have talked about so far is known as the _trunk_ of the blockchain. -Farmers have no say in how their block is constructed in the trunk, since they must use the exact proof of space, VDFs, and signatures that are specified. In order to include farming rewards, as well as transactions, in the system, we must introduce an additional component of blocks called _foliage_. +Farmers have no say in how their block is constructed in the trunk, since they must use the exact proof of space, VDFs, and signatures that are specified. In order to include farming rewards, as well as transactions, in the system, we must introduce an additional component to the reward chain called _foliage_. -**Trunk**: The component of blocks and the blockchain which includes VDFs, proofs of space, PoSpace signatures, challenges, and previous trunk blocks, and is completely canonical. The trunk never refers to the foliage chain. +**Trunk**: The component of blocks and the blockchain which includes VDFs, proofs of space, PoSpace signatures, challenges, and previous trunk blocks, and is completely canonical. The trunk includes each of the [three VDF chains](/three-vdf-chains), but it never refers to the foliage. -**Foliage**: The component of blocks and the blockchain which includes specification of where rewards should go, which transactions should be included, and what the previous foliage block is. This is up to the farmer to decide and is grindable, so it can never be used as input to the challenges. +**Foliage**: An extension of the blocks produced in the reward chain. A block's foliage includes the specification of where rewards should go, which transactions should be included, and what the previous block's foliage is. -**Re-org**: A re-org (or reorganization) is when a node's view of the peak changes, such that the old view contains a block that is not included in the new view (some block has been reversed). Both trunk and foliage re-orgs are possible, but should be rare in practice, and low in depth. +:::info + +Foliage provides a separation between the transactions and the consensus. + +A given block's farmer decides what is included in the foliage, thereby allowing the farmer to grind on its contents. If the transactions and the consensus were not separated, a farmer could grind on the foliage in order to gain an unfair edge in the consensus, which would allow them to win more blocks. For this reason, the foliage is kept separate from the consensus, and it can never be used as input to the challenges. + +It is also important to note that in the implementation, when a farmer submits a block, the trunk and foliage are both submitted together -- the two pieces are not calculated and submitted at separate times. The reason we emphasize the separation of the transactions and the consensus is because the farmer may not modify a block's trunk, but retains total control over the foliage. + +::: + +**Re-org**: A re-org (or reorganization) is when a node's view of the peak changes, such that the old view contains a block that is not included in the new view (one or more blocks have either been removed, or have changed order). Both trunk and foliage re-orgs are possible, but should be rare in practice, and low in depth. -In figure 11 below we can see that the foliage is added to blocks to produce an additional chain. This foliage includes a hash of the previous foliage, a reward block hash, and a signature. These foliage pointers are separate from the trunk chain, and are not canonical. That is, farmers could theoretically create a foliage re-org where foliage is replaced, but the exact same trunk (proofs of space and time) are used. +In figure 11 below we can see that the foliage is added to the blocks formed in the reward chain. This foliage includes a hash of the previous foliage, a reward block hash, and a signature. These foliage pointers are separate from the trunk chain, and are not canonical. That is, farmers could theoretically create a foliage re-org where foliage is replaced, but the exact same trunk (proofs of space and time) are used. -To prevent a foliage re-org, honest farmers only create one foliage block per block. As soon as one honest farmer has added a foliage block, the foliage becomes impossible to re-org beyond that height with the same PoSpace, since that farmer will not sign again with the same PoSpace. +To prevent a foliage re-org, honest farmers only create one set of foliage per block. As soon as one honest farmer has added foliage to a block, the foliage becomes impossible to re-org beyond that height with the same PoSpace, since that farmer will not sign again with the same PoSpace. -Furthermore, blocks like B3, which come parallel with another foliage block (B2), do not have to sign the previous foliage block, since they do not necessarily have enough time to see it. +Furthermore, blocks like B3, which come parallel with the foliage of another block (B2), do not have to sign the previous block's foliage, since they do not necessarily have enough time to see it. :::info @@ -33,12 +43,12 @@ Blocks which have red pointers are also eligible to create transactions, and are In the diagram, sp3 comes before B2, (a transaction block, and the previous block of B3), so B3 cannot be a transaction block. -The red arrows provide security by burying foliage blocks, but the gray arrows do not. The purpose of the gray arrows is to maintain a linked list in the foliage, and to reduce complexity in implementations. However, blocks with gray arrows pointing to them do get buried in the next-next block. +The red arrows provide security by burying foliage, but the gray arrows do not. The purpose of the gray arrows is to maintain a linked list in the foliage, and to reduce complexity in implementations. However, foliages with gray arrows pointing to them do get buried in the next-next block.
drawing
-Figure 11: Foliage blocks and trunk blocks. Blocks B1, B2, and B4 have transactions and have red pointers (pointers to last block). Note that the start of the sub-slot is also a signage point. +Figure 11: Foliage and trunk blocks. Blocks B1, B2, and B4 have transactions and have red pointers (pointers to last block). Note that the start of the sub-slot is also a signage point.
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md index 13a81c3f80..44cdb78587 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md @@ -3,12 +3,14 @@ title: Forks slug: /consensus-forks --- -The following table is a comprehensive list of all forks (planned and activated) on Chia's blockchain. It was last updated on 2023-09-10. +The following table is a comprehensive list of all forks (planned and activated) on Chia's blockchain. It was last updated on 2023-09-10. It was last updated on 2023-09-10. -| Activation Block | Activation Date | Type | Build | Status | Description | -| :--------------- | :-------------- | :--- | :---- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `2 300 000` | 2022-07-22 | Soft | 1.3.0 | Activated | [Disallow negative division](https://www.chia.net/2022/03/04/divided-we-fork/) | -| `3 630 000` | 2023-05-07 | Soft | 1.7.0 | Activated | [Restrict `AGG_SIG_UNSAFE` message](https://github.com/Chia-Network/post-mortem/blob/main/2023-05/2023-05-08-AGG_SIG_UNSAFE-can-mimic-AGG_SIG_ME-condition.md) | -| `3 886 635` | 2023-07-01 | Soft | 1.8.0 | Activated | [CHIP-14](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0014.md) -- `ASSERT_BEFORE_*` conditions | -| `4 510 000` | 2023-11-12 | Soft | 2.0.0 | Activated | [CHIP-11](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md) -- BLS/SECP CLVM Operators | -| `5 496 000` | 2024-06 | Hard | 2.1.0 | Released,
Not Activated | [CHIP-12](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0012.md) -- Decrease plot filter | +| Activation Block | Activation Date | Type | Build | Status | Description | +|:---------------- |:--------------- |:---- |:----- |:----------------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `2 300 000` | 2022-07-22 | Soft | 1.3.0 | Activated | [Disallow negative division](https://www.chia.net/2022/03/04/divided-we-fork/) | +| `3 630 000` | 2023-05-07 | Soft | 1.7.0 | Activated | [Restrict `AGG_SIG_UNSAFE` message](https://github.com/Chia-Network/post-mortem/blob/main/2023-05/2023-05-08-AGG_SIG_UNSAFE-can-mimic-AGG_SIG_ME-condition.md) | +| `3 886 635` | 2023-07-01 | Soft | 1.8.0 | Activated | [CHIP-14](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0014.md) -- `ASSERT_BEFORE_*` conditions | +| `4 510 000` | 2023-11-12 | Soft | 2.0.0 | Activated | [CHIP-11](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md) -- BLS/SECP CLVM Operators | +| `5 496 000` | 2024-06-13 | Hard | 2.1.0 | Activated | [CHIP-12](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0012.md) -- Decrease plot filter | +| `5 716 000` | 2024-07 | Soft | 2.3.0 | Released,
Not Activated | [CHIP-25](https://github.com/Chia-Network/chips/pull/98) -- Chialisp Message Conditions | +| `5 940 000` | 2024-09 | Soft | 2.4.0 | Released,
Not Activated | Disallow infinity G1 points | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md index ce91f5321f..7c603d5b39 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md @@ -11,7 +11,7 @@ The challenge and reward chains both have signage points. The infused challenge ::: -The signage points occur every 9.375 seconds (64 signage points per 600-second sub-slot). The number of iterations between each signage point is **sp_interval_iterations**, which is equal to sub-slot_iterations / 64. +The signage points occur every 9.375 seconds (64 signage points per 600-second sub-slot). The number of iterations between each signage point is **_sp_interval_iterations_**, which is equal to _sub-slot_iterations / 64_. The challenge at the start of the sub-slot is also a valid signage point. As each of the 64 signage points in the sub-slot is reached, those points are broadcast, starting from the fastest timelord's full node, and propagating to every other full node on the network. @@ -35,13 +35,13 @@ For both of our [previous example](/consensus-challenges), as well as the next e ::: -- sub-slot_iterations = 100,000,000 -- sp_interval_iterations = `sub-slot_iterations` / 64 = 1,562,500 +- _sub-slot_iterations = 100,000,000_ +- _sp_interval_iterations = `sub-slot_iterations` / 64 = 1,562,500_ -The farmer computes the **required_iterations** for each proof of space. If the required_iterations < sp_interval_iterations, the proof of space is eligible for inclusion into the blockchain. At this point, the farmer fetches the entire proof of space from disk (which requires 64 disk seeks, or 640 ms on a slow HDD), creates an unfinished block, and broadcasts it to the network. +The farmer computes the **required_iterations** for each proof of space. If the required_iterations < sp_interval_iterations, the proof of space is eligible for inclusion into the blockchain. At this point, the farmer fetches the entire proof of space from disk (which requires 64 disk seeks, or 640 ms on a slow HDD), creates an unfinished block, and broadcasts it to the network. If the _required_iterations < sp_interval_iterations_, the proof of space is eligible for inclusion into the blockchain. At this point, the farmer fetches the entire proof of space from disk (which requires 64 disk seeks, or 640 ms on a slow HDD), creates an unfinished block, and broadcasts it to the network. :::info -For the vast majority of eligible plots, required_iterations will be far too high, since on average 32 will qualify for the whole network for each 10-minute sub-slot. This is a random process so it's possible (though unlikely) for a large number of proofs to qualify. The signage_point_iterations is the number of iterations from the start of the sub-slot to the signage point. Any plot that does meet the required_iterations for a signage point will qualify as there is no rivalry between winning plots. +For the vast majority of eligible plots, _required_iterations_ will be far too high, since on average 32 will qualify for the whole network for each 10-minute sub-slot. This is a random process so it's possible (though unlikely) for a large number of proofs to qualify. Any plot that does meet the _required_iterations_ for a signage point will qualify as there is no rivalry between winning plots. ::: The exact method for required_iterations is the following: @@ -54,17 +54,19 @@ required_iterations = (difficulty // pow(2, 256) * expected_plot_size(size)) ``` -The difficulty constant factor is based on the initial constants of the blockchain. For Chia, it is `2^67`. The difficulty varies per epoch, as explained in the [Epoch and Difficulty page](/epoch-and-difficulty). As you can see, the **sp_quality_string** is converted into a random number between 0 and 1, by dividing it by `2^256`, and then multiplied by the plot size. +The difficulty constant factor is based on the initial constants of the blockchain. For Chia, it is _2^67_. The difficulty varies per epoch, as explained in [Section 3.11](/epoch-and-difficulty) 'Section 3.11: Epochs and Difficulty Adjustment'). As you can see, the `sp_quality_string` is converted into a random number between 0 and 1, by dividing it by _2^256_, and then multiplied by the plot size. -For consensus purposes, the `expected_plot_size` is `((2 * k) + 1) * (2 ** (k - 1)).`, where k>=32\<50. The actual plot size is that value times a constant factor, in bytes. This is because each entry in the plot is around `k+0.5` bits, and there are around `2^(k)` entries. +For consensus purposes, the `expected_plot_size` is `((2 * k) + 1) * (2 ** (k - 1)).`, where k>=32\<50. The actual plot size is that value times a constant factor, in bytes. This is because each entry in the plot is around `k+0.5` bits, and there are around `2^(k)` entries. The actual plot size is that value times a constant factor, in bytes. This is because each entry in the plot is around `k+0.5` bits, and there are around `2 ** k` entries. -The **infusion_iterations** is the number of iterations from the start of the sub-slot at which the block with at least the required quality can be included into the blockchain. This is calculated as: +The _signage_point_iterations_ is the number of iterations from the start of the sub-slot to the signage point. + +The **infusion_iterations** is the number of iterations from the start of the sub-slot at which the block with at least the required quality can be included into the blockchain. This is calculated as: This is calculated as: ``` infusion_iterations = ( signage_point_iterations + 3 * sp_interval_iterations + required_iterations) % sub-slot_iterations ``` -Therefore, infusion_iterations will be between 3 and 4 signage points after the current signage point. Farmers must submit their proofs and blocks before the infusion point is reached. The modulus is there to allow overflows into the next sub-slot, if the signage point is near the end of the sub-slot. This is expanded on in the [Overflow Blocks and Weight page](/overflow-blocks). +Therefore, _infusion_iterations_ will be between 3 and 4 signage points after the current signage point. Farmers must submit their proofs and blocks before the infusion point is reached. The modulus is there to allow overflows into the next sub-slot, if the signage point is near the end of the sub-slot. This is expanded on in [Section 3.9](/overflow-blocks) 'Section 3.9: Overflow Blocks and Weight'). :::info More information on infusion points is available in the [VDFs page](/proof-of-time#infusion). @@ -81,41 +83,37 @@ Figure 5 shows the infusion point as a green square marked `b1`. The first and l At `b1`, the farmer's block gets combined with the VDF output for that point. This creates a new input for the VDF from that point on, i.e. we infuse the farmer's block into the VDF. `b1` is only fully valid after two events have occurred: -1. infusion_iterations has been reached, and -2. Two VDF proofs have been included: one from `r1` to the signage point and one from `r1` to `b1`. (Actually it's more since there are three VDF chains, explained in the [Three VDF Chains page](/three-vdf-chains)). +1. _infusion_iterations_ has been reached, and +2. Two VDF proofs have been included: one from `r1` to the signage point and one from `r1` to `b1`. (Actually it's more since there are three VDF chains, explained in [Section 3.8](/three-vdf-chains) 'Section 3.8: Three VDF Chains')). -In Figure 5, the farmer creates the block at the time of the signage point, `b1'`. However, `b1'` is not finished yet, since it needs the infusion point VDF. Once the infusion_iterations VDF has been released, it is added to `b1'` to form the finished block at `b1`. +In Figure 5, the farmer creates the block at the time of the signage point, `b1'`. However, `b1'` is not finished yet, since it needs the infusion point VDF. Once the _infusion_iterations_ VDF has been released, it is added to `b1'` to form the finished block at `b1`. Recall that in this example, -- sub-slot_iterations = 100M -- sp_interval_iterations is 1.5625M. Furthermore, let's say a farmer has a total of 1000 plots. +- _sub-slot_iterations = 100,000,000_ +- _= (signage \* point \* sp \* interval_iterations) + (3 \* sp_interval_iterations) + required_iterations_ -For each of the 64 signage points, as they are released to the network every 9.375 seconds, or every 1.5625M iterations, the farmer computes the plot filter and sees how many plots pass. For each passing plot, the farmer calculates required_iterations. +For each of the 64 signage points, as they are released to the network every 9.375 seconds, or every 1.5625M iterations, the farmer computes the plot filter and sees how many plots pass. For each passing plot, the farmer calculates required_iterations. For each passing plot, the farmer calculates _required_iterations_. -Let's say the farmer calculates required_iterations < 1.5625M once in the sub-slot. (We'll assume the exact required_iterations = 0.7828M in this instance.) Figure 5 shows this happening at the 20th signage point. +Let's say the farmer calculates required_iterations < 1.5625M once in the sub-slot. (We'll assume the exact required_iterations = 0.7828M in this instance.) Figure 5 shows this happening at the 20th signage point. (We'll assume the exact _required_iterations = 782,800_ in this instance.) Figure 5 shows this happening at the 20th signage point. infusion_iterations is then computed as: +``` infusion_iterations = signage_point_iterations + (3 \* sp_interval_iterations) + required_iterations +``` -= (signage \* point \* sp \* interval_iterations) + (3 \* sp_interval_iterations) + required_iterations - -= (20 \* 1.5625M) + (3 \* 1.5626M) + 0.7827M - -= 36.7223M - -After realizing they have won (at the 20th infusion point), the farmer fetches the whole proof of space, makes a block (optionally including transactions), and broadcasts this to the network. The block has until infusion_iterations (typically a few seconds) to reach timelords, who will infuse the block, creating the infusion point VDFs. With these VDFs, the block can be finished and added to the blockchain by full nodes. +After realizing they have won (at the 20th infusion point), the farmer fetches the whole proof of space, makes a block (optionally including transactions), and broadcasts this to the network. The block has until _infusion_iterations_ (typically a few seconds) to reach timelords, who will infuse the block, creating the infusion point VDFs. With these VDFs, the block can be finished and added to the blockchain by full nodes. ## Rationale for choosing 64 signage points -Chia's original consensus, which was phased out before the launch of mainnet, used a single signage point per 10-minute subslot. This left the network vulnerable to short-range [replotting attacks](/consensus-attacks#replotting), where an attacker initiates a plot's creation after a signage point, and completes the plot before the next infusion point. The attacker could always choose a plot that passes the plot filter (because the signage point is hashed with the subslot challenge and the plot ID in calculating the filter) and then delete the plot after the infusion point. For a 512-filter, this would result in the attacker mimicking 512 plots (~51 TiB). In reality, under the original consensus, he or she would only need to own single computer capable of creating a plot in less than ten minutes. +Chia's original consensus, which was phased out before the launch of mainnet, used a single signage point per 10-minute subslot. This left the network vulnerable to short-range [replotting attacks](/consensus-attacks#replotting), where an attacker initiates a plot's creation after a signage point, and completes the plot before the next infusion point. The attacker could always choose a plot that passes the plot filter (because the signage point is hashed with the subslot challenge and the plot ID in calculating the filter) and then delete the plot after the infusion point. For a 512-filter, this would result in the attacker mimicking 512 plots (~51 TiB). In reality, under the original consensus, they would only need to own single computer capable of creating a plot in less than ten minutes. :::note Technically this isn't an _attack_ because -- even if successful -- the "attacker" wouldn't gain an ability to cheat the network. However the "attacker" _would_ be using the network in an unintended way, effectively turning Chia into a Proof of Work system. Therefore, Chia's new consensus was intentionally designed to discourage this behavior. ::: -The new consensus was introduced during Chia's beta phase. One of the modifications was to increase the number of signage points to 64 per 10-minute subslot, or one every 9.375 (600/64) seconds, on average. The Challenge Chain was also introduced (see the [Three VDF Chains page](/three-vdf-chains) for more info). The maximum distance between a signage point and the next infusion point is now 4 signage points (see the `infusion_iterations` formula, above), or 37.5 seconds. This is the maximum amount of time for the attack to be possible, but for it to be consistently applied, the minimum time of 28.125 seconds must be applied. Assuming a few extra seconds for network latency and other factors, the attack is now only possible if one can create a new plot in less than 25 seconds. +The new consensus was introduced during Chia's beta phase. One of the modifications was to increase the number of signage points to 64 per 10-minute subslot, or one every 9.375 (600/64) seconds, on average. The Challenge Chain was also introduced (see the [Three VDF Chains page](/three-vdf-chains) for more info). The maximum distance between a signage point and the next infusion point is now 4 signage points (see the _infusion_iterations_ formula, above), or 37.5 seconds. This is the maximum amount of time for the attack to be possible, but for it to be consistently applied, the minimum time of 28.125 seconds must be applied. Assuming a few extra seconds for network latency and other factors, the attack is now only possible if one can create a new plot in less than 25 seconds. :::note Keep in mind that this "attack" is really mimicking the ownership of around 51 TiB of storage. Even when it does become possible to run the attack consistently, it will likely be much cheaper to use the network as intended, storing plots on non-volatile storage. @@ -127,14 +125,14 @@ This begs the question: why not use even more signage points in the consensus? T **Quality string**: A small part of the proof of space, 2 _x values_ out of the total 64 _x values_, which can be retrieved efficiently from disk, and which values_to_fetch is determined by the signage point. -**sp_quality_string**: A hash of the quality string concatenated with the challenge chain's signage point. This hash is what ultimately decides the "luck" of a certain proof, using the size of required_iterations. +**sp_quality_string**: A hash of the quality string concatenated with the challenge chain's signage point. This hash is what ultimately decides the "luck" of a certain proof, using the size of required_iterations. This hash is what ultimately decides the "luck" of a certain proof, using the size of _required_iterations_ **sp_interval_iterations**: Defined as floor(sub-slot_iterations / 64). **Signage points**: 64 intermediary points in time within a sub-slot in both the challenge and reward chains, for which VDFs are periodically released. At each signage point, a VDF output is created and broadcast through the network. The first signage point in the sub-slot is the challenge itself. Each block has a signage point such that the proof of space in the block must be eligible for that signage point. -**required_iterations**: A number computed using the quality string, used to choose proofs of space which are eligible to make blocks. The vast majority of proofs of space will have required_iterations which are too high, and thus not eligible for inclusion into the chain. This number is used to compute the infusion point. +**required_iterations**: A number computed using the quality string, used to choose proofs of space which are eligible to make blocks. The vast majority of proofs of space will have required_iterations which are too high, and thus not eligible for inclusion into the chain. This number is used to compute the infusion point. The vast majority of proofs of space will have _required_iterations_ which are too high, and thus not eligible for inclusion into the chain. This number is used to compute the infusion point. -**Infusion point**: The point in time at infusion_iterations from the challenge point, for a proof of space with a certain challenge and infusion_iterations. At this point, the farmer's block gets infused into the reward chain VDF. The infusion point of a block is always between 3 and 4 signage points after the signage point of that block. Computed as signage_point_iterations + 3 \* sp_interval_iterations + required_iterations. +**Infusion point**: The point in time at infusion_iterations from the challenge point, for a proof of space with a certain challenge and infusion_iterations. At this point, the farmer's block gets infused into the reward chain VDF. The infusion point of a block is always between 3 and 4 signage points after the signage point of that block. Computed as signage_point_iterations + 3 \* sp_interval_iterations + required_iterations. At this point, the farmer's block gets infused into the reward chain VDF. The infusion point of a block is always between 3 and 4 signage points after the signage point of that block. Computed as _signage_point_iterations + 3 \* sp_interval_iterations + required_iterations_. The delay between the signage point and infusion point has many benefits, including defense against orphaning and selfish farming, decreased forks, and no VDF pauses. This delay of around 28 seconds is given so that farmers have enough time to sign without delaying the slot VDF. Well-behaving farmers sign only one signage point with each proof of space, meaning that attackers cannot easily reorg the chain. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contribution/using-github.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contribution/using-github.md new file mode 100644 index 0000000000..2f1652f485 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contribution/using-github.md @@ -0,0 +1,243 @@ +--- +title: Using Github for Chia Contributions +slug: /contribution/using-github +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +import ForkButton from '@site/static/img/contributing/fork-button.webp'; +import CodeButton from '@site/static/img/contributing/code-button.webp'; +import AddGPG from '@site/static/img/contributing/userbar-account-settings-global-nav-update.webp'; + +## Using GitHub + +We use Github for source code control, the two main ways to interact with Github are via the web browser or via cli commands, the below links are focused on the web browser access. + +### Create a Github Account + +:::info +The below information has been copied from the [Github docs](https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github). +::: + +To get started with GitHub, you'll need to create a free personal account on GitHub.com and verify your email address. + +Every person who uses GitHub.com signs in to a personal account. Your personal account is your identity on GitHub.com and has a username and profile. For example, see [@octocat's profile](https://github.com/octocat). + +Later, you can explore the different types of accounts that GitHub offers, and decide if you need a billing plan. For more information, see ["Types of GitHub accounts"](https://docs.github.com/en/get-started/learning-about-github/types-of-github-accounts) and ["GitHub’s plans"](https://docs.github.com/en/get-started/learning-about-github/githubs-plans). + +#### Signing up for a Personal Account + +1. Navigate to https://github.com/. +2. Click Sign up. +3. Follow the prompts to create your personal account. + +During sign up, you'll be asked to verify your email address. Without a verified email address, you won't be able to complete some basic GitHub tasks, such as creating a repository. + +If you're having problems verifying your email address, there are some troubleshooting steps you can take. For more information, see ["Verifying your email address"](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address#troubleshooting-email-verification). + +--- + +### Installing Github Desktop + +:::info +The below information has been adapted from the [Github docs](https://docs.github.com/en/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop). +::: + +You can install GitHub Desktop on Windows 10 64-bit or later. + +:::warning +You must have a 64-bit operating system to run GitHub Desktop. +::: + +1. Visit the [download page for GitHub Desktop](https://desktop.github.com/). +2. Click Download for Windows. +3. In your computer's Downloads folder, double-click the GitHub Desktop setup file. +4. GitHub Desktop will launch after installation is complete. + +--- + +### Forking a Repository + +:::info +The below information has been adapted from the [Github docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo). +::: + +A fork is a new repository that shares code and visibility settings with the original “upstream” repository. The below example is for the chia-docs repo but the same process can be followed for any of the public Chia-Network repos. + +1. On GitHub.com, navigate to the [Chia-Network/chia-docs](https://github.com/Chia-Network/chia-docs) repository. +2. In the top-right corner of the page, click Fork. + +
+ Fork a Repository in Github +
+
+ +3. Under "Owner," select the dropdown menu and click an owner for the forked repository. +4. By default, forks are named the same as their upstream repositories. Optionally, to further distinguish your fork, in the "Repository name" field, type a name. +5. Optionally, in the "Description" field, type a description of your fork. +6. Optionally, select **Copy the DEFAULT branch only**. + For many forking scenarios, such as contributing to open-source projects, you only need to copy the default branch. If you do not select this option, all branches will be copied into the new fork. +7. Click **Create fork**. + +:::note +If you want to copy additional branches from the upstream repository, you can do so from the Branches page. For more information, see ["Creating and deleting branches within your repository"](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository). +::: + +#### Cloning a Forked Repository + +:::info +The below information has been adapted from the [Github docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo?tool=webui#cloning-your-forked-repository). +::: + +Right now, you have a fork of the chia-docs repository, but you do not have the files in that repository locally on your computer. + +1. On GitHub.com, navigate to your fork of the Chia-Network/chia-docs repository. +2. Above the list of files, click **Code**. + +
+ Clone a Repository in Github +
+
+ +3. Click "Open with Github Desktop" (this clones the repo locally where you can edit it) + +--- + +### Setup Commit Signing + +All Chia related Github repos require the signing of commits, follow the outlined process to setup automated commit signing for the Github Desktop Application. + +#### Generating a New GPG Key + +:::info +The below information has been adapted from the [Github docs](https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key). +::: + +:::note +Note: Before generating a new GPG key, make sure you've verified your email address. If you haven't verified your email address, you won't be able to sign commits and tags with GPG. For more information, see ["Verifying your email address"](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address). +::: + +1. Download and install [the GPG command line tools](https://www.gnupg.org/download/) for your operating system. We generally recommend installing the latest version for your operating system. + +2. Open Git Bash. + +3. Generate a GPG key pair. Since there are multiple versions of GPG, you may need to consult the relevant [man page](https://en.wikipedia.org/wiki/Man_page) to find the appropriate key generation command. + + - If you are on version 2.1.17 or greater, paste the text below to generate a GPG key pair. + + ```shell + gpg --full-generate-key + ``` + + - If you are not on version 2.1.17 or greater, the gpg --full-generate-key command doesn't work. Paste the text below and skip to step 6. + + ```shell + gpg --default-new-key-algo rsa4096 --gen-key + ``` + +4. At the prompt, specify the kind of key you want, or press `Enter` to accept the default. + +5. At the prompt, specify the key size you want, or press `Enter` to accept the default. + +6. Enter the length of time the key should be valid. Press `Enter` to specify the default selection, indicating that the key doesn't expire. Unless you require an expiration date, we recommend accepting this default. + +7. Verify that your selections are correct. + +8. Enter your user ID information. + :::note + When asked to enter your email address, ensure that you enter the verified email address for your GitHub account. To keep your email address private, use your GitHub-provided no-reply email address. For more information, see "Verifying your email address" and "Setting your commit email address." + ::: + +9. Type a secure passphrase. + +10. Use the `gpg --list-secret-keys --keyid-format=long` command to list the long form of the GPG keys for which you have both a public and private key. A private key is required for signing commits or tags. + +```shell + gpg --list-secret-keys --keyid-format=long +``` + +:::note +Some GPG installations on Linux may require you to use `gpg2 --list-keys --keyid-format` LONG to view a list of your existing keys instead. In this case you will also need to configure Git to use gpg2 by running `git config --global gpg.program gpg2`. +::: + +11. From the list of GPG keys, copy the long form of the GPG key ID you'd like to use. In this example, the GPG key ID is `3AA5C34371567BD2`: + +```shell + $ gpg --list-secret-keys --keyid-format=long + /Users/hubot/.gnupg/secring.gpg + ------------------------------------ + sec 4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10] + uid Hubot + ssb 4096R/4BB6D45482678BE3 2016-03-10 +``` + +12. Paste the text below, substituting in the GPG key ID you'd like to use. In this example, the GPG key ID is `3AA5C34371567BD2`: + +``` + gpg --armor --export 3AA5C34371567BD2 + # Prints the GPG key ID, in ASCII armor format +``` + +13. Copy your GPG key, beginning with `-----BEGIN PGP PUBLIC KEY BLOCK-----` and ending with `-----END PGP PUBLIC KEY BLOCK-----`. +14. [Add the GPG key to your GitHub account](https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account). + +#### Configure Git to Sign Commits by Default + +``` +- open Git Bash and run `git config --global commit.gpgsign true` +``` + +#### Store your GPG Key Passphrase + +:::info +Storing your passphrase ensures you don't have to enter it every time you want to sign a commit, this is strictly optional. +::: + +- For Mac users, the [GPG Suite](https://gpgtools.org/) allows you to store your GPG key passphrase in the macOS Keychain. +- For Windows users, the [Gpg4win](https://www.gpg4win.org/) integrates with other Windows tools. +- You can also manually configure [gpg-agent](http://linux.die.net/man/1/gpg-agent) to save your GPG key passphrase, but this doesn't integrate with macOS Keychain like ssh-agent and requires more setup. + +#### Add a GPG Key to Your GitHub Account + +:::info +The below information has been adapted from the [Github docs](https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account). +::: + +1. In the upper-right corner of any page, click your profile photo, then click `Settings`. + +
+ Add a GPG Key to Your Github Account +
+
+ +2. In the "Access" section of the sidebar, click **SSH and GPG keys**. +3. Next to the "GPG keys" header, click **New GPG key**. +4. In the "Title" field, type a name for your GPG key. +5. In the "Key" field, paste the GPG key you copied when you [generated your GPG key](https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key). +6. Click **Add GPG key**. +7. To confirm the action, authenticate to your GitHub account. + +--- + +### Making a Pull Request + +:::info +The below information has been adapted from the [Github docs](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project#making-a-pull-request). +::: + +At last, you're ready to propose changes into the main project! This is the final step in producing a fork of someone else's project, and arguably the most important. If you've made a change that you feel would benefit the community as a whole, you should definitely consider contributing back. + +1. To do so, head on over to the repository on GitHub where your project lives. For this example, it would be at `https://github.com//chia-docs`. +2. You'll see a banner indicating that your branch is one commit ahead of chia-docs:main. Click **Contribute** and then **Open a pull request**. +3. GitHub will bring you to a page that shows the differences between your fork and the Chia-Network/chia-docs repository. Click **Create pull request**. + - GitHub will bring you to a page where you can enter a title and a description of your changes. It's important to provide as much useful information and a rationale for why you're making this pull request in the first place. The project owner needs to be able to determine whether your change is as useful to everyone as you think it is. +4. Finally, click **Create pull request**. + +--- + +## Contribution support + +Join Our [Discord](https://discord.gg/chia) and jump into the #support channel for support. + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/dev-guides-home.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/dev-guides-home.md index bea0c87fae..cfbce03c75 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/dev-guides-home.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/dev-guides-home.md @@ -52,114 +52,70 @@ Embark on a swift journey into Chia Network's Crash Course for developers. Start
-
-
- Intro to Developing on Chia + +
+
+ Intro to Developing on Chia +
-
- - - -
-
+
-
-
- Intro to Chialisp -
-
-
-
-
-
- Intro to Smart Coins -
-
-
-
-
-
- Intro to Signatures -
-
-
-
-
-
- Intro to State -
-
- - - + +
+
+ Intro to State +
-
+
-
-
- Intro to Inner Puzzles -
-
-
-
-
-
- Intro to Cats, Offers, and NFTs -
-
-
-
-
-
- Chialisp and Typescript + +
+
+ Chialisp and Typescript +
-
- - - -
-
+
@@ -175,100 +131,79 @@ Explore the core building blocks of Chia development in the Primitives section.
-
-
- NFTs + +
+
+ NFTs +
-
- - - -
-
+
-
-
- CATs -
-
- - - + +
+
+ CATs +
-
+
-
-
- DataLayer™ -
-
- - - + +
+
+ DataLayer™ +
-
+
-
-
- Clawback + +
+
+ Clawback +
-
- - - -
-
+
-
-
- Offers + +
+
+ Offers +
-
- - - -
-
+
-
-
- DAOs + +
+
+ DAOs +
-
- - - -
-
+
-
-
- Verifiable Credentials -
-
- - - + +
+
+ Verifiable Credentials +
-
+
@@ -284,101 +219,64 @@ Immerse yourself in Chia Network's Tutorials section for developers. Understand
-
-
- Application Structure + +
+
+ Application Structure +
-
- - - -
-
+
-
-
- Custom Puzzle Lock -
-
-
-
-
-
- Custody Tool + +
+
+ Custody Tool +
-
- - - -
-
+
-
-
- RPC Coin Spend -
-
-
-
-
-
- Seeder User Guide -
-
- - - + +
+
+ Seeder User Guide +
-
+
-
-
- Simulator User Guide -
-
-
-
-
-
- WalletConnect -
-
-
-
@@ -393,157 +291,100 @@ Dive into the Video Series of Chia Network's Developer Guides for a dynamic lear
-
-
- Why Chia is Great -
-
-
-
-
-
- Developing Chia Applications -
-
-
-
-
-
- Tools and Setup + +
+
+ Tools and Setup +
-
- - - -
-
+
-
-
- Programming in ChiaLisp -
-
- - - + +
+
+ Programming in ChiaLisp +
-
+
-
-
- Coin Lifecycle -
-
-
-
-
-
- Singleton Contracts -
-
- - - + +
+
+ Singleton Contracts +
-
+
-
-
- State, Coins, and Announcements -
-
-
-
-
-
- Security, Arguments, and Signing + +
+
+ Security, Arguments, and Signing +
-
- - - -
-
+
-
-
- Announcements and Oracles -
-
- - - + +
+
+ Announcements and Oracles +
-
+
-
-
- Single Issuance CATs -
-
-
-
-
-
- Multiple Issuance CATs -
-
-
-
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/docs-home.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/docs-home.md index 130aae18c8..e8155c8fb8 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/docs-home.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/docs-home.md @@ -47,58 +47,38 @@ Embark on your Chia Network journey with our Beginner Documentation! Uncover the
-
-
- Intro to Chia + +
+
+ Intro to Chia +
-
- - - -
-
+
-
-
- Beginners Farming Guide -
-
-
-
-
-
- Beginners Wallet Guide -
-
-
-
-
-
- Using the GUI -
-
- - - + +
+
+ Using the GUI +
-
+
@@ -114,115 +94,95 @@ Explore the advanced features of Chia Network through our comprehensive document
-
-
- Advanced Installation + +
+
+ Advanced Installation +
-
- - - -
-
+
-
-
- Testnets -
-
- - - + +
+
+ Testnets +
-
+
-
-
- Plotting Deep Dive + +
+
+ Plotting Deep Dive +
-
- - - -
-
+
-
-
- Farming Deep Dive -
-
+ + + + + + + + + + + +
-
-
-
-
- Reference Client Deep Dive + +
+
+ Reference Client Deep Dive +
-
- - - -
-
+
-
-
- RPC Reference + +
+
+ RPC Reference +
-
- - - -
-
+
-
-
- CLI Reference + +
+
+ CLI Reference +
-
- - - -
-
+
-
-
- WalletConnect Reference -
-
-
-
@@ -237,44 +197,31 @@ Navigate Chia Network's Troubleshooting Documentation with precision. Check the
-
-
- Check if Things are Working -
-
- - - + +
+
+ Check if Things are Working +
-
+
-
-
- Node Syncing -
-
-
-
-
-
- Logging Reference + +
+
+ Logging Reference +
-
- - - -
-
+
@@ -290,100 +237,71 @@ Embark on a knowledge journey through Chia Network's Learn documentation. Delve
-
-
- CoinSet Model + +
+
+ CoinSet Model +
-
- - - -
-
+
-
-
- Architecture + +
+
+ Architecture +
-
- - - -
-
+
-
-
- Blockchain Consensus -
-
- - - + +
+
+ Blockchain Consensus +
-
+
-
-
- Chia Keys -
-
-
-
-
-
- Protocol -
-
- - - + +
+
+ Protocol +
-
+
-
-
- Green Paper -
-
-
-
-
-
- Resources + +
+
+ Resources +
-
- - - -
-
+
@@ -399,44 +317,35 @@ Dive into Chia Network's Developer Guides for an immersive experience. Begin wit
-
-
- Chia Crash Course + +
+
+ Chia Crash Course +
-
- - - -
-
+
-
-
- Primitives + +
+
+ Primitives +
-
- - - -
-
+
-
-
- Tutorials -
-
- - - + +
+
+ Tutorials +
-
+
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/checking-farm-health.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/checking-farm-health.md index d1c64e337b..efb8c501f2 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/checking-farm-health.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/checking-farm-health.md @@ -5,9 +5,9 @@ slug: /checking-farm-health > "Is my farm working?" -It's one of the most common questions farmers ask themselves. This is understandable -- it is possible for those with small- and medium-size farms to go weeks or months without winning a block reward, even if everything is working properly. +It's one of the most common questions farmers ask themselves. It's one of the most common questions farmers ask themselves. This is understandable -- it is possible for those with small- and medium-size farms to go weeks or months without winning a block reward, even if everything is working properly. -The easiest mitigation against this anxiety is to [join a pool](/pool-farming). Your pool will occasionally send you partial challenges in order to estimate your farm's size. If everything is working properly, your pool will report a size for your farm that comes close to its actual size. +The easiest mitigation against this anxiety is to [join a pool](/pool-farming). Your pool will occasionally send you partial challenges in order to estimate your farm's size. If everything is working properly, your pool will report a size for your farm that comes close to its actual size. Your pool will occasionally send you partial challenges in order to estimate your farm's size. If everything is working properly, your pool will report a size for your farm that comes close to its actual size. Beyond joining a pool, there are a few other things you can do to make sure your farm is working properly, whether you use the GUI or the CLI. @@ -28,32 +28,32 @@ Here is how to interpret each of the statistics in the above image: #### Farm Health - **Sync status** -- Shows whether your full node is synced. -- **Plots passing filter** -- Shows whether the "correct" number of plots are passing the [plot filter](https://help.chia.net/hc/en-us/articles/8373437367191-What-is-the-plot-filter-and-why-didn-t-my-plot-pass-it-). The popup, as shown in the above image, contains several stats. As long as the numbers next to `Total plots passing filter` and `Expected Total plots passing filter` are similar, this aspect of your farm is working properly. -- **Missing signage points** -- Chia's consensus is designed such that 64 [signage points](/signage-and-infusion-points) are broadcast every 10 minutes, or 9216 signage points per day. You are ineligible to win a block at any missed signage points. It is normal to miss a few signage points per day, for example due to a temporary outage in your local network. However, if you miss 100 or more signage points per day, there is likely something wrong. The two most common causes for this are that your harvester is overwhelmed (fix this by moving some HDDs to another harvester), or that your network is experiencing frequent outages. -- **Stale partials** -- Your pool will send partial challenges to your node in order to estimate how much space you are contributing. If your node doesn't respond to a partial challenge quickly, it will be considered "stale". Just as with missing signage points, an occasional stale partial is nothing to worry about. If you experience a frequent number of stale partials, the causes and solutions tend to be the same as with missing signage points. +- **Plots passing filter** -- Shows whether the "correct" number of plots are passing the [plot filter](https://help.chia.net/hc/en-us/articles/8373437367191-What-is-the-plot-filter-and-why-didn-t-my-plot-pass-it-). The popup, as shown in the above image, contains several stats. As long as the numbers next to `Total plots passing filter` and `Expected Total plots passing filter` are similar, this aspect of your farm is working properly. The popup, as shown in the above image, contains several stats. As long as the numbers next to `Total plots passing filter` and `Expected Total plots passing filter` are similar, this aspect of your farm is working properly. +- **Missing signage points** -- Chia's consensus is designed such that 64 [signage points](/signage-and-infusion-points) are broadcast every 10 minutes, or 9216 signage points per day. You are ineligible to win a block at any missed signage points. It is normal to miss a few signage points per day, for example due to a temporary outage in your local network. However, if you miss 100 or more signage points per day, there is likely something wrong. The two most common causes for this are that your harvester is overwhelmed (fix this by moving some HDDs to another harvester), or that your network is experiencing frequent outages. You are ineligible to win a block at any missed signage points. It is normal to miss a few signage points per day, for example due to a temporary outage in your local network. However, if you miss 100 or more signage points per day, there is likely something wrong. The two most common causes for this are that your harvester is overwhelmed (fix this by moving some HDDs to another harvester), or that your network is experiencing frequent outages. +- **Stale partials** -- Your pool will send partial challenges to your node in order to estimate how much space you are contributing. If your node doesn't respond to a partial challenge quickly, it will be considered "stale". Just as with missing signage points, an occasional stale partial is nothing to worry about. If you experience a frequent number of stale partials, the causes and solutions tend to be the same as with missing signage points. If your node doesn't respond to a partial challenge quickly, it will be considered "stale". Just as with missing signage points, an occasional stale partial is nothing to worry about. If you experience a frequent number of stale partials, the causes and solutions tend to be the same as with missing signage points. #### Netspace - **Total Netspace** -- This shows an estimate of the total amount of space on Chia's entire network. -- **Farming Space** -- This is hidden behind the popup dialog in the above image. It is your local node's contribution of space to the network. +- **Farming Space** -- This is hidden behind the popup dialog in the above image. It is your local node's contribution of space to the network. It is your local node's contribution of space to the network. #### Farming Rewards - **Estimated Time to Win** -- This is only an estimation of when you will create your next block, based on the percentage of the total netspace you are contributing. You have a 50% chance of winning sooner than this, and a 50% chance of winning later. It is not uncommon for 5x this amount of time to elapse between block wins, even if your farm is set up perfectly. Also keep in mind that the probability that you will win the next block does not increase as more time elapses. The Gambler's Fallacy applies here. -- **Estimated daily XCH** -- The formula for this is `(1 day / Estimated Time to Win) * block reward`. If you join a pool, this is roughly how much you should receive each day. However, you need to account for pool fees, as well as the fact that 1/8 of the reward goes directly to the farmer. +- **Estimated daily XCH** -- The formula for this is `(1 day / Estimated Time to Win) * block reward`. If you join a pool, this is roughly how much you should receive each day. However, you need to account for pool fees, as well as the fact that 1/8 of the reward goes directly to the farmer. If you join a pool, this is roughly how much you should receive each day. However, you need to account for pool fees, as well as the fact that 1/8 of the reward goes directly to the farmer. - **Estimated monthly XCH** -- Same as above, but taken as a monthly estimate. #### Pooling Health -- **Valid Partials** -- Partial proofs your node has successfully returned to your pool, expressed as both a number and a percentage. See above for more info on partials. +- **Valid Partials** -- Partial proofs your node has successfully returned to your pool, expressed as both a number and a percentage. See above for more info on partials. See above for more info on partials. - **Stale Partials** -- The percent and number of partials your node has failed to return on time. - **Invalid partials** -- The percent and number of partials your node has returned that were invalid. - **Missing partials** -- The percent and number of partials your node has failed to return. #### Last Attempted Proof -- **Plots Passed Filter** -- At each signage point, a certain number of your plots will pass the plot filter. The numerator indicates the number of plots that are eligible to play in that specific Proof of Space lottery. For small farms, this number is often 0. The denominator indicates your farm's total number of plots. -- **Proofs Found** -- The number of valid proofs found at that signage point. If you are not in a pool, a number greater than 0 indicates that you have successfully found a proof and will likely win a block reward at the next transaction block. If you are in a pool, a number greater than 0 likely means that a valid partial proof was found and will be returned to your pool. +- **Plots Passed Filter** -- At each signage point, a certain number of your plots will pass the plot filter. The numerator indicates the number of plots that are eligible to play in that specific Proof of Space lottery. For small farms, this number is often 0. The denominator indicates your farm's total number of plots. The numerator indicates the number of plots that are eligible to play in that specific Proof of Space lottery. For small farms, this number is often 0. The denominator indicates your farm's total number of plots. +- **Proofs Found** -- The number of valid proofs found at that signage point. If you are not in a pool, a number greater than 0 indicates that you have successfully found a proof and will likely win a block reward at the next transaction block. If you are in a pool, a number greater than 0 likely means that a valid partial proof was found and will be returned to your pool. If you are not in a pool, a number greater than 0 indicates that you have successfully found a proof and will likely win a block reward at the next transaction block. If you are in a pool, a number greater than 0 likely means that a valid partial proof was found and will be returned to your pool. ### Harvest panel @@ -66,13 +66,13 @@ Here is how to interpret each of the statistics in the above image: In the above image: - **Total farm size raw** -- The actual amount of space your farm is contributing to the network. -- **Total farm size effective** -- The amount of space your farm is effectively contributing, with uncompressed (C0) plots as the baseline. For example, if your farm consists entirely of C3 plots, according to the [plot compression table](/plotting-compression#compression-table), your farm's effective size should be 20% larger than its actual size. If you are using plots with a mixture of compression levels, the effective size of each of your plots will be taken into account in this number's calculation. +- **Total farm size effective** -- The amount of space your farm is effectively contributing, with uncompressed (C0) plots as the baseline. For example, if your farm consists entirely of C3 plots, according to the [plot compression table](/plotting-compression#compression-table), your farm's effective size should be 20% larger than its actual size. If you are using plots with a mixture of compression levels, the effective size of each of your plots will be taken into account in this number's calculation. For example, if your farm consists entirely of C3 plots, according to the [plot compression table](/plotting-compression#compression-table), your farm's effective size should be 20% larger than its actual size. If you are using plots with a mixture of compression levels, the effective size of each of your plots will be taken into account in this number's calculation. ## CLI Health ### Check if your farm thinks it's farming -Before going further, please make sure whether your farm actually considers itself to be farming. There's a good chance that you might not since you are still syncing blocks. +Before going further, please make sure whether your farm actually considers itself to be farming. There's a good chance that you might not since you are still syncing blocks. There's a good chance that you might not since you are still syncing blocks. 要检查您农场的状态，请像往常一样运行 `../activate` 命令（译注：仅通过源码方式安装才需要输入此命令），然后输入 `chia farm summary`。 如果输出的第一行看起来像这样： @@ -98,7 +98,7 @@ farmer: ### 检查是否有地块通过了初筛 -The most important metric to look out for is, whether your plots are passing the plot filter on your harvesting machines. 在通常的设置中，这涉及查看`~/.chia/mainnet/log`目录下的日志，在某些回合中，农场机器是否将地块标记为**可进行耕种**（eligible for farming）。 +The most important metric to look out for is, whether your plots are passing the plot filter on your harvesting machines. 在通常的设置中，这涉及查看`~/.chia/mainnet/log`目录下的日志，在某些回合中，农场机器是否将地块标记为**可进行耕种**（eligible for farming）。 在通常的设置中，这涉及查看`~/.chia/mainnet/log`目录下的日志，在某些回合中，农场机器是否将地块标记为**可进行耕种**（eligible for farming）。 `~/.chia/mainnet/log`目录可能看起来像这样： @@ -119,13 +119,13 @@ username@chia-farmer:~/.chia/mainnet/log$ tree 0 directories, 8 files ``` -Each log file contains log information about all the services ran by Chia. 如果运行的是一个全节点，这些日志可能会很复杂。 We're only interested whether or not plots pass the plot filter. 可以通过运行以下命令来检查： +Each log file contains log information about all the services ran by Chia. 如果运行的是一个全节点，这些日志可能会很复杂。 如果运行的是一个全节点，这些日志可能会很复杂。 We're only interested whether or not plots pass the plot filter. 可以通过运行以下命令来检查： 可以通过运行以下命令来检查： ```bash cat debug.log | grep "[0-9] plots were eligible for farming" ``` -The `cat` command is a \*nix program to get content of a file. With the pipe operator `|`we "pipe" the output to another program called `grep` which can filter textual input. 使用`grep`来过滤出现`"[0-9] plots were eligible for farming"`的内容，以查看是否已经有了符合条件的地块。 +The `cat` command is a \*nix program to get content of a file. With the pipe operator `|`we "pipe" the output to another program called `grep` which can filter textual input. 使用`grep`来过滤出现`"[0-9] plots were eligible for farming"`的内容，以查看是否已经有了符合条件的地块。 With the pipe operator `|`we "pipe" the output to another program called `grep` which can filter textual input. 使用`grep`来过滤出现`"[0-9] plots were eligible for farming"`的内容，以查看是否已经有了符合条件的地块。 示例输出可能如下所示： @@ -157,11 +157,11 @@ cat debug.log | grep "Found [1-9] proofs" 12:30:01.492 harvester src.harvester.harvester : INFO 1 plots were eligible for farming 23d3a7c90f... Found 1 proofs. Time: 0.57000 s. Total 100 plots Found 1 proofs. Time: 0.57000 s. Total 100 plots ``` -If you do this for all your log files and get a result, **great!** This means your farm is 100% working as expected. 可能还没有赢得一个区块，但已经接近成功了一次或多次！ +If you do this for all your log files and get a result, **great!** This means your farm is 100% working as expected. 可能还没有赢得一个区块，但已经接近成功了一次或多次！ 可能还没有赢得一个区块，但已经接近成功了一次或多次！ ### Can a Double NAT scenario impact my farm's ability to send valid proofs to the network? -是也不是。 Double NAT, while quirky, should work due to Chia's uPnP support. 然而，您可能无法通过这种方式将区块发送给其他节点。 "双重NAT"场景发生在客户端（收割机或节点）位于进行了两次NAT的网络内。 通常涉及客户端位于两个路由器后面，而不是一个，如下图所示： +是也不是。 Double NAT, while quirky, should work due to Chia's uPnP support. 然而，您可能无法通过这种方式将区块发送给其他节点。 然而，您可能无法通过这种方式将区块发送给其他节点。 "双重NAT"场景发生在客户端（收割机或节点）位于进行了两次NAT的网络内。 通常涉及客户端位于两个路由器后面，而不是一个，如下图所示： 互联网 --> 路由器 --> 路由器 --> 客户端 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md index 5d013fe53f..425c3ad176 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md @@ -3,9 +3,9 @@ title: Farming Basics slug: /farming-basics --- -耕种（Farming）是[生成地块](/plotting-basics)（plotting）后的下一步。 Once a plot has been created, you have a chance of winning Chia as long as the file is being stored and the Chia farming software is running. +耕种（Farming）是[生成地块](/plotting-basics)(/plotting-basics)（plotting）后的下一步。 Once a plot has been created, you have a chance of winning Chia as long as the file is being stored and the Chia farming software is running. -When farming, you allocate a certain amount of storage space in order to have a chance at winning Chia. The more plots you have, the higher your chances of winning. +When farming, you allocate a certain amount of storage space in order to have a chance at winning Chia. The more plots you have, the higher your chances of winning. The more plots you have, the higher your chances of winning. Farming is similar to a lottery. Each plot acts like a lottery ticket, where a new drawing is performed every 9 seconds or so. If you win the lottery, you earn the right to create a new block, and you will be rewarded with Chia. With an average of 4608 blocks a day, you'll have many chances to win. @@ -21,21 +21,21 @@ Prior wins (or lack thereof) do not determine new wins. 如果预计获得奖励 ## 使用联合耕种池来应对 -To combat the infrequency and inconsistency of winning, you can [join a pool](/pool-farming). It works similar to a lottery pool. Instead of occasionally earning a large reward, you will frequently earn a small payment. In the long run, pooling and solo-farming (aka **self-pooling**) will yield the same result (minus any pool fee), but pooling is much more predictable, and recommended for most farmers. +To combat the infrequency and inconsistency of winning, you can [join a pool](/pool-farming). It works similar to a lottery pool. Instead of occasionally earning a large reward, you will frequently earn a small payment. In the long run, pooling and solo-farming (aka **self-pooling**) will yield the same result (minus any pool fee), but pooling is much more predictable, and recommended for most farmers. It works similar to a lottery pool. Instead of occasionally earning a large reward, you will frequently earn a small payment. In the long run, pooling and solo-farming (aka **self-pooling**) will yield the same result (minus any pool fee), but pooling is much more predictable, and recommended for most farmers. -An additional benefit of pooling is instant feedback as to whether your farm is running properly. 如果是独自耕种，可能会不确定自己是否真的能赢得一个区块。 +An additional benefit of pooling is instant feedback as to whether your farm is running properly. 如果是独自耕种，可能会不确定自己是否真的能赢得一个区块。 如果是独自耕种，可能会不确定自己是否真的能赢得一个区块。 Chia设计了官方的联合耕种协议（pooling protocol），以一种其他加密货币从未尝试过的方式引入了矿池。 This allows for officially-supported predictability without compromising on decentralization. ## 区块奖励 -With each new block, a certain amount of Chia is rewarded to the farmer that created it. Chia launched with a block reward of 2 XCH per block. This comes out to 64 XCH distributed every 10 minutes. +With each new block, a certain amount of Chia is rewarded to the farmer that created it. With each new block, a certain amount of Chia is rewarded to the farmer that created it. Chia launched with a block reward of 2 XCH per block. This comes out to 64 XCH distributed every 10 minutes. This comes out to 64 XCH distributed every 10 minutes. -Every three years, there is a scheduled halving of the block reward. This means that three years after mainnet launch, the block reward is cut in half, to 1 XCH. +Every three years, there is a scheduled halving of the block reward. Every three years, there is a scheduled halving of the block reward. This means that three years after mainnet launch, the block reward is cut in half, to 1 XCH. 以下是完整的区块奖励计划： -| 年份 | 区块奖励 | XCH / 10 mins | +| 年份 | 区块奖励 | XCH / 10 mins | | ----- | --------- | ------------- | | 1-3 | 2.0 XCH | 64 | | 4-6 | 1.0 XCH | 32 | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-compressed-plots.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-compressed-plots.md index 22ec12eccc..eadf555019 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-compressed-plots.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-compressed-plots.md @@ -7,13 +7,13 @@ slug: /farming-compressed-plots import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -As detailed in the [plotting](/plotting-basics) section, compressed plots are supported for both plotting and harvesting as of Chia version 2.0. Before you can harvest compressed plots, you need to inform your harvesters of the fact that they exist. +As detailed in the [plotting](/plotting-basics) section, compressed plots are supported for both plotting and harvesting as of Chia version 2.0. Before you can harvest compressed plots, you need to inform your harvesters of the fact that they exist. Before you can harvest compressed plots, you need to inform your harvesters of the fact that they exist. :::info -As of Chia version 2.0, decompression must be performed at the harvester level. You therefore will need to apply the settings listed on this page to each of your harvesters individually. This also means that each individual harvester will need to be capable of decompressing the plots that have been installed locally. +As of Chia version 2.0, decompression must be performed at the harvester level. You therefore will need to apply the settings listed on this page to each of your harvesters individually. As of Chia version 2.0, decompression must be performed at the harvester level. You therefore will need to apply the settings listed on this page to each of your harvesters individually. This also means that each individual harvester will need to be capable of decompressing the plots that have been installed locally. -In the future, we plan to enable decompression at the farmer level. This means that only one computer on your network will need to be equipped with a fast CPU or GPU for decompressing plots. +In the future, we plan to enable decompression at the farmer level. In the future, we plan to enable decompression at the farmer level. This means that only one computer on your network will need to be equipped with a fast CPU or GPU for decompressing plots. ::: @@ -22,44 +22,42 @@ In the future, we plan to enable decompression at the farmer level. This means t ### GUI 1. Navigate to the `Settings` panel in the lower-left corner of the GUI. -2. Click the `HARVESTER` tab at the top of the panel. The following screen will appear: +2. Click the `HARVESTER` tab at the top of the panel. The following screen will appear: The following screen will appear:
Enable compressed farming
3. Slide the `Enable compressed plot support` slider to the right, as shown in the above image. -4. For `Parallel Decompressor Count`, the default value of `1` will be fine for most users. Here are some details: +4. For `Parallel Decompressor Count`, the default value of `1` will be fine for most users. Here are some details: Here are some details: - This number _only_ affects the amount of memory used for decompression. - - The amount memory required will vary according to the level of compression. For example, if `Parallel Decompressor Count` is set to `1`, around 600-700 MB of memory will be consumed while decompressing a single C7 plot. + - The amount memory required will vary according to the level of compression. The amount memory required will vary according to the level of compression. For example, if `Parallel Decompressor Count` is set to `1`, around 600-700 MB of memory will be consumed while decompressing a single C7 plot. - The amount of memory required will scale linearly, so setting it to `2` will double the required memory. - If your harvester has sufficient memory, as well as a high CPU core count, you can increase this number. For example, `2` might be optimal for a 16-core CPU, or `4` for dual 32-core CPUs. + If your harvester has sufficient memory, as well as a high CPU core count, you can increase this number. For example, `2` might be optimal for a 16-core CPU, or `4` for dual 32-core CPUs. For example, `2` might be optimal for a 16-core CPU, or `4` for dual 32-core CPUs. - However, the generation and speed of your CPU will also have a large impact on the optimal setting. If you do increase `Parallel Decompressor Count`, be sure to monitor your harvester's performance as there is no one-size-fits-all solution. + However, the generation and speed of your CPU will also have a large impact on the optimal setting. However, the generation and speed of your CPU will also have a large impact on the optimal setting. If you do increase `Parallel Decompressor Count`, be sure to monitor your harvester's performance as there is no one-size-fits-all solution. -5. The default value for `Decompressor Thread Count` is `0`. This is the number of threads that will participate in decompressing plots. This number, multiplied by `Parallel Decompressor Count`, needs to less than or equal to the total number of harvester cores. +5. The default value for `Decompressor Thread Count` is `0`. This is the number of threads that will participate in decompressing plots. This number, multiplied by `Parallel Decompressor Count`, needs to less than or equal to the total number of harvester cores. This is the number of threads that will participate in decompressing plots. This number, multiplied by `Parallel Decompressor Count`, needs to less than or equal to the total number of harvester cores. -For example, if your harvester has one CPU with eight cores, you might use the following settings: -_ `Parallel Decompressor Count`: `1` -_ `Decompressor Thread Count`: `6` +For example, if your harvester has one CPU with eight cores, you might use the following settings: _ `Parallel Decompressor Count`: `1` _ `Decompressor Thread Count`: `6` This would instruct the harvester process to use six of the eight cores for decompressing plots, and to use the remaining cores to run the OS, etc. 5. If you want to use a GPU for harvesting, slide the `Enable GPU Harvesting` slider to the right, as shown in the above image. Note that in order to use this setting, your harvester must have an NVIDIA CUDA-class GPU. For harvesting C7 plots, 600-700 MB of DRAM is required. 6. If your harvester has multiple GPUs, you can use `GPU Device Index` to choose which one to use. If your harvester only has one GPU, then leave this set to `0`. -After all of these settings have been properly set, click the red `RESTART LOCAL HARVESTER TO APPLY CHANGES` button. After your harvester restarts, it will use the updated settings. +After all of these settings have been properly set, click the red `RESTART LOCAL HARVESTER TO APPLY CHANGES` button. After your harvester restarts, it will use the updated settings. After your harvester restarts, it will use the updated settings. ### CLI All of the new harvester settings live inside `~/.chia/mainnet/config/config.yaml`. -If you have never installed Chia on this harvester, `config.yaml` won't exist. In this case, run the following command to generate a new copy: +If you have never installed Chia on this harvester, `config.yaml` won't exist. In this case, run the following command to generate a new copy: In this case, run the following command to generate a new copy: ```bash chia init ``` -If you have previously installed Chia on this computer, then `config.yaml` likely already exists. In this case, you will need to add several new settings. However, +If you have previously installed Chia on this computer, then `config.yaml` likely already exists. In this case, you will need to add several new settings. However, In this case, you will need to add several new settings. However, - If you run `chia init` when the config file already exists, Chia won't make any modifications. - If you delete `config.yaml` and run `chia init`, the new settings will be added, but you will lose any custom changes you previously made. @@ -81,16 +79,16 @@ disable_cpu_affinity: false max_compression_level_allowed: 7 ``` -At this point, regardless of whether you are upgrading or running a new build of Chia on this harvester, your copy of `config.yaml` contains all of the latest settings. Their definitions and recommended values are as follows: +At this point, regardless of whether you are upgrading or running a new build of Chia on this harvester, your copy of `config.yaml` contains all of the latest settings. Their definitions and recommended values are as follows: Their definitions and recommended values are as follows: - `parallel_decompressor_count`: The number of CPUs to be used for decompressing plots. If this is set to `0`, then harvesting of compressed plots will be disabled. For GPU harvesting, set this value to `1`. For CPU harvesting, set it to the number of CPUs you want to use for decompression (typically `1`). -- `decompressor_thread_count`: The number of CPU threads that will participate in decompressing plots. This number multiplied by `Parallel Decompressor Count` needs to less than or equal to the total number of CPU cores. -- `use_gpu_harvesting`: Set to `true` to enable harvesting with a GPU. Note that in order to use this setting, your harvester must have an NVIDIA GPU with CUDA capability 5.2 and up, with at least 8GB of vRAM. -- `gpu_index`: If your harvester has multiple GPUs, use this setting to choose which one to use. If your harvester only has one GPU, then leave this set to `0`. +- `decompressor_thread_count`: The number of CPU threads that will participate in decompressing plots. `decompressor_thread_count`: The number of CPU threads that will participate in decompressing plots. This number multiplied by `Parallel Decompressor Count` needs to less than or equal to the total number of CPU cores. +- `use_gpu_harvesting`: Set to `true` to enable harvesting with a GPU. `use_gpu_harvesting`: Set to `true` to enable harvesting with a GPU. Note that in order to use this setting, your harvester must have an NVIDIA GPU with CUDA capability 5.2 and up, with at least 8GB of vRAM. +- `gpu_index`: If your harvester has multiple GPUs, use this setting to choose which one to use. If your harvester only has one GPU, then leave this set to `0`. If your harvester only has one GPU, then leave this set to `0`. - `enforce_gpu_index`: Set to `true` if your harvester has more than one GPU and you want to use one other than the default of `0`. -- `decompressor_timeout`: The number of seconds for your decompressor to time out. The default value of `20` is typically fine. -- `disable_cpu_affinity`: This should typically be `false`. When it is `false`, when using multiple CPU decompressors, each with multiple threads, the threads for each decompressor will be assigned to different physical CPUs. This prevents them for competing over compute time. If it is set to `true`, the threads for each decompressor will be assigned to the same CPU. -- `max_compression_level_allowed`: The highest level of compression your harvester will support. In Chia version 2.0, the maximum level is `7`. This will likely be increased in the future, but for now, you cannot increase it beyond the default. You can, however, set it to a lower number if desired. +- `decompressor_timeout`: The number of seconds for your decompressor to time out. The default value of `20` is typically fine. The default value of `20` is typically fine. +- `disable_cpu_affinity`: This should typically be `false`. `disable_cpu_affinity`: This should typically be `false`. When it is `false`, when using multiple CPU decompressors, each with multiple threads, the threads for each decompressor will be assigned to different physical CPUs. This prevents them for competing over compute time. If it is set to `true`, the threads for each decompressor will be assigned to the same CPU. This prevents them for competing over compute time. If it is set to `true`, the threads for each decompressor will be assigned to the same CPU. +- `max_compression_level_allowed`: The highest level of compression your harvester will support. In Chia version 2.0, the maximum level is `7`. This will likely be increased in the future, but for now, you cannot increase it beyond the default. You can, however, set it to a lower number if desired. In Chia version 2.0, the maximum level is `7`. This will likely be increased in the future, but for now, you cannot increase it beyond the default. You can, however, set it to a lower number if desired. After you have finished making these updates, save `config.yaml` and restart your harvester by running the following command: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md index 980ed502b8..acbc7c17ff 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md @@ -13,9 +13,9 @@ Always make sure to protect yourself from malicious actors by [securing your chi ::: -This guide will show you how to run a harvester on each machine in your network. This architecture is composed of one main machine which runs the farmer, full node, and wallet, and other machines which run only the harvester. 只有主机将连接到Chia网络。 +This guide will show you how to run a harvester on each machine in your network. This architecture is composed of one main machine which runs the farmer, full node, and wallet, and other machines which run only the harvester. 只有主机将连接到Chia网络。 This architecture is composed of one main machine which runs the farmer, full node, and wallet, and other machines which run only the harvester. 只有主机将连接到Chia网络。 -This is the recommended setup for all Chia farms that use more than one computer. It uses less bandwidth, space and CPU versus running a full node on each computer. It also keeps your keys safer because they will only need to be stored on one computer. Finally, it makes your overall farm quicker and more efficient when replying to challenges. +This is the recommended setup for all Chia farms that use more than one computer. It uses less bandwidth, space and CPU versus running a full node on each computer. It also keeps your keys safer because they will only need to be stored on one computer. Finally, it makes your overall farm quicker and more efficient when replying to challenges. It uses less bandwidth, space and CPU versus running a full node on each computer. It also keeps your keys safer because they will only need to be stored on one computer. Finally, it makes your overall farm quicker and more efficient when replying to challenges. 为了保障收割节点与主机之间的通信安全，使用TLS（Transport Layer Security）协议，其中**主机**将充当私有证书颁发机构(CA)，用于签署所有证书。 每个收割节点必须拥有自己的签名证书，以便与**主机**正确通信。 @@ -26,7 +26,7 @@ This is the recommended setup for all Chia farms that use more than one computer \_____ 收割机 3 (证书 C) ``` -If you are more of a visual learner, JM made a video outlining the steps from this tutorial. This video is from 2021, but the steps are still relevant today: +If you are more of a visual learner, JM made a video outlining the steps from this tutorial. This video is from 2021, but the steps are still relevant today: This video is from 2021, but the steps are still relevant today: @@ -52,7 +52,7 @@ If you are more of a visual learner, JM made a video outlining the steps from th 在生成地块后，请运行`chia plots check`命令确保一切正常运行。 -- A copy of your **main** machine CA directory needs to be accessible by your harvester machines. This directory is located in: +- A copy of your **main** machine CA directory needs to be accessible by your harvester machines. This directory is located in: This directory is located in: ```bash ~/.chia/mainnet/config/ssl/ca @@ -88,7 +88,7 @@ chia init -c :::warning -For step 4, you are using a copy of your `/ca` directory from your main machine temporarily. 请勿替换收割节点上的`/ca`文件夹。 将`/ca`目录放入收割节点上的临时文件夹中。 将暂时向收割节点展示这些文件，然后可以删除临时文件夹中的`/ca`目录。 This keeps your system more secure by limiting the exposure to your certificates. +For step 4, you are using a copy of your `/ca` directory from your main machine temporarily. 请勿替换收割节点上的`/ca`文件夹。 请勿替换收割节点上的`/ca`文件夹。 将`/ca`目录放入收割节点上的临时文件夹中。 将暂时向收割节点展示这些文件，然后可以删除临时文件夹中的`/ca`目录。 This keeps your system more secure by limiting the exposure to your certificates. ::: @@ -98,7 +98,7 @@ For step 4, you are using a copy of your `/ca` directory from your main machine ~/.chia/mainnet/config/config.yaml ``` -Search for the remote **`harvester`**'s farmer_peer section (NOT `full_node`). Enter the local IP address of your main machine (typically `192.168.xxx.yyy`) as the `host` value. +Search for the remote **`harvester`**'s farmer_peer section (NOT `full_node`). Enter the local IP address of your main machine (typically `192.168.xxx.yyy`) as the `host` value. Enter the local IP address of your main machine (typically `192.168.xxx.yyy`) as the `host` value. In other words, replace `` in the following snippet with your main machine's local IP: @@ -187,7 +187,7 @@ chia start -r farmer #### 在多台机器上生成地块 -As stated [above](/farming-on-many-machines#先决条件), run the following command when creating plots: +As stated [above](/farming-on-many-machines#prerequisites), run the following command when creating plots: ```bash chia plots create -f -p @@ -197,7 +197,7 @@ When you use the `-f` and `-p` parameters, you do not need to copy the keys to t #### 在多台机器上进行收割 -Rather than maintaining a copy of your farmer's certificates on each harvester, follow the [above](/farming-on-many-machines#先决条件) steps to keep them in one place while farming. +Rather than maintaining a copy of your farmer's certificates on each harvester, follow the [above](/farming-on-many-machines#prerequisites) steps to keep them in one place while farming. ### 钱包保持独立(Separate) diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md index a51b1a451e..0572af6973 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md @@ -15,13 +15,13 @@ Chia的联合耕种协议（pooling protocol）允许将地块分配给“联合 :::note -The official pooling protocol was introduced in verion 1.2 in mid-2021. All plots created before this point, as well as newer plots created with following the pooling protocol, are not eligible for pooling. If you have any of these "OG" plots, you can either recreate them using a plot NFT, or co-farm them on the same machine as your official pool plots. +The official pooling protocol was introduced in verion 1.2 in mid-2021. All plots created before this point, as well as newer plots created with following the pooling protocol, are not eligible for pooling. The official pooling protocol was introduced in verion 1.2 in mid-2021. All plots created before this point, as well as newer plots created with following the pooling protocol, are not eligible for pooling. If you have any of these "OG" plots, you can either recreate them using a plot NFT, or co-farm them on the same machine as your official pool plots. ::: ### 第一步：同步全节点和钱包 -In order to set up your farm for pooling, you need to have a synced full node and wallet. In the upper-right corner of your wallet, you should see green icons next to `FUll NODE` and `WALLET`: +In order to set up your farm for pooling, you need to have a synced full node and wallet. In the upper-right corner of your wallet, you should see green icons next to `FUll NODE` and `WALLET`: In the upper-right corner of your wallet, you should see green icons next to `FUll NODE` and `WALLET`:
Sync status @@ -37,7 +37,7 @@ For more info, see our [blog post](https://www.chia.net/2023/03/19/introducing-c ### 第二步：获取一些XCH -开始联合耕种之前，请确保钱包里面拥有一小笔XCH。 可以向朋友索取mojo（1 mojo等于0.000000000001 XCH），或者到https://faucet.chia.net/获取mojo。 You can use the receive address on the `Tokens` page, and you can also create new receive addresses. Any of the receive addresses can be used; they are all part of the same wallet. +开始联合耕种之前，请确保钱包里面拥有一小笔XCH。 可以向朋友索取mojo（1 mojo等于0.000000000001 XCH），或者到https://faucet.chia.net/获取mojo。 You can use the receive address on the `Tokens` page, and you can also create new receive addresses. Any of the receive addresses can be used; they are all part of the same wallet. Any of the receive addresses can be used; they are all part of the same wallet. ### 第三步：创建联合耕种农田（Plot NFT） @@ -59,7 +59,7 @@ chia plotnft create -s local chia plotnft create -s pool -u https://bar.examplepool.org ``` -请注意，即便选择的是选项1，以后仍然可以加入联合耕种池，并且可以随时切换到其它池。 如果决定加入一个联合耕种池，请输入网址 (必须以 *https://*开头)，然后查看描述。 如果同意, 则开始创建联合耕种农田, 并等待它被确认 (只点击一次)。 这可能需要几分钟的时间才能得到确认，然后出现在“联合耕种”选项卡中。 您只需要 1 个联合耕种农田。 +请注意，即便选择的是选项1，以后仍然可以加入联合耕种池，并且可以随时切换到其它池。 如果决定加入一个联合耕种池，请输入网址 (必须以 _https://_开头)，然后查看描述。 如果同意, 则开始创建联合耕种农田, 并等待它被确认 (只点击一次)。 这可能需要几分钟的时间才能得到确认，然后出现在“联合耕种”选项卡中。 您只需要 1 个联合耕种农田。 #### 使用图形用户界面（GUI） @@ -71,9 +71,9 @@ Click the `Pooling` icon on the left side of your wallet, and click `JOIN A POOL
-Select `Connect to pool`. You will need to enter a valid pool URL. For a list of Chia pools, see [chialinks.com](https://chialinks.com/pools). +Select `Connect to pool`. You will need to enter a valid pool URL. Select `Connect to pool`. You will need to enter a valid pool URL. For a list of Chia pools, see [chialinks.com](https://chialinks.com/pools). -Creating a plot NFT requires an on-chain transaction that will cost one mojo. You are also recommended to enter a blockchain fee. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes. +Creating a plot NFT requires an on-chain transaction that will cost one mojo. You are also recommended to enter a blockchain fee. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes. You are also recommended to enter a blockchain fee. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes.
Create a plot NFT @@ -81,7 +81,7 @@ Creating a plot NFT requires an on-chain transaction that will cost one mojo. Yo
-If you entered a valid pool URL, the details will pop up. If everything looks acceptable, click `CREATE`: +If you entered a valid pool URL, the details will pop up. For example, this pool has a fee of 1%. If everything looks acceptable, click `CREATE`: If everything looks acceptable, click `CREATE`:
Pool details @@ -89,7 +89,7 @@ If you entered a valid pool URL, the details will pop up. If everything looks ac
-Your transaction will be pushed to the blockchain. While it is pending, a new screen will appear: +Your transaction will be pushed to the blockchain. While it is pending, a new screen will appear: While it is pending, a new screen will appear:
Plot NFT pending @@ -116,7 +116,7 @@ Detailed instructions can be found in the "How to Plot" page: ### 第五步：管理联合耕种农田。 -You should see your plots in the `Pooling` dialog. The status should say `Pooling``. 在这里，可以看到当前农田的难度，已获得的积分（points）以及联合耕种池认为您拥有的积分（积分余额）。 +You should see your plots in the `Pooling` dialog. The status should say `Pooling``. 在这里，可以看到当前农田的难度，已获得的积分（points）以及联合耕种池认为您拥有的积分（积分余额）。 The status should say `Pooling`. 在这里，可以看到当前农田的难度，已获得的积分（points）以及联合耕种池认为您拥有的积分（积分余额）。
Plot NFT details @@ -128,7 +128,7 @@ You should see your plots in the `Pooling` dialog. The status should say `Poolin 积分是一种计算地块找到了多少证明的方式。 每个K32地块每天平均会获得10个积分，与难度无关。 积分与Chia（XCH）不同。 积分只是反映了进行了多少耕种的值。 可以将其视为一种会计工具。 根据您获得的积分数，由联合耕种池定期发放XCH，并将您的积分重置为0，这是矿池的责任。 -To change pools, click on the `CHANGE POOL` button and enter the new pool URL. 请注意，更改联合耕种池有一个等待期，可能会持续几分钟到一小时左右。 请在此过程中不要关闭应用程序。 可以随意更改联合耕种池，而且不需要进行注册或支付任何罚款。 请注意，如果更改了联合耕种池，之前的耕种池不再有义务继续向你支付收益。 +To change pools, click on the `CHANGE POOL` button and enter the new pool URL. 请注意，更改联合耕种池有一个等待期，可能会持续几分钟到一小时左右。 请注意，更改联合耕种池有一个等待期，可能会持续几分钟到一小时左右。 请在此过程中不要关闭应用程序。 可以随意更改联合耕种池，而且不需要进行注册或支付任何罚款。 请注意，如果更改了联合耕种池，之前的耕种池不再有义务继续向你支付收益。 您应该确保在过去24小时内的积分数是准确的。 每天每个k32地块应该获得大约10个积分，所以如果有100个k32的地块，每天应该获得大约1000个积分。 确保您的积分在持续增长。 支付后，积分余额将重置为零。 积分将随机出现，因为查找证明也是随机的。 因此，预计会有很多变化，并且会有好运和坏运的时候。 @@ -144,7 +144,7 @@ To change pools, click on the `CHANGE POOL` button and enter the new pool URL. ### 多台电脑 -You can take your 24-word seed phrase and enter it into a different computer, and when it is synched, the current Plot NFTs and pool information will be automatically downloaded from the blockchain. All information about your pool, plot NFTs, and smart contract addresses is completely backed up on the blockchain, and can be recovered using the seed phrase. +You can take your 24-word seed phrase and enter it into a different computer, and when it is synched, the current Plot NFTs and pool information will be automatically downloaded from the blockchain. All information about your pool, plot NFTs, and smart contract addresses is completely backed up on the blockchain, and can be recovered using the seed phrase. All information about your pool, plot NFTs, and smart contract addresses is completely backed up on the blockchain, and can be recovered using the seed phrase. ### 多个密钥 @@ -156,7 +156,7 @@ You can take your 24-word seed phrase and enter it into a different computer, an ### 区块链手续费 -Blockchain fees are paid to the creator of the block (farmers), to incentivize them to include your transaction. If the blockchain is busy, you might have to pay small a small fee to get your transaction included. (Creating a plot NFT and changing pools both require an on-chain transaction.) +Blockchain fees are paid to the creator of the block (farmers), to incentivize them to include your transaction. If the blockchain is busy, you might have to pay small a small fee to get your transaction included. (Creating a plot NFT and changing pools both require an on-chain transaction.) If the blockchain is busy, you might have to pay small a small fee to get your transaction included. (Creating a plot NFT and changing pools both require an on-chain transaction.) ### 无效状态 @@ -238,11 +238,11 @@ chia plotnft show ### 什么是联合耕种农田？ -一个联合耕种农田（plot NFT）是区块链上的智能币或代币，允许用户管理他们在耕种池中的成员资格。 Users can assign the plot NFT to any pool they want, at any point. 在生成地块时，可以选择一个农田，并且该地块将永远与该农田绑定在一起。 农田是“非同质化”的，因为它们不可互换；每个农田代表一个独特的耕种池合约。 +一个联合耕种农田（plot NFT）是区块链上的智能币或代币，允许用户管理他们在耕种池中的成员资格。 Users can assign the plot NFT to any pool they want, at any point. 在生成地块时，可以选择一个农田，并且该地块将永远与该农田绑定在一起。 在生成地块时，可以选择一个农田，并且该地块将永远与该农田绑定在一起。 农田是“非同质化”的，因为它们不可互换；每个农田代表一个独特的耕种池合约。 ### 需要支付XCH来创建联合耕种农田或切换耕种池吗？ -Each plot NFT you create will require 1 mojo (1 trillionth of a XCH) + transaction fee. 切换耕种池只需要支付交易手续费。 如果您没有任何XCH，可以从Chia的官方水龙头获得100个mojo：https://faucet.chia.net/ +Each plot NFT you create will require 1 mojo (1 trillionth of a XCH) + transaction fee. 切换耕种池只需要支付交易手续费。 切换耕种池只需要支付交易手续费。 如果您没有任何XCH，可以从Chia的官方水龙头获得100个mojo：https://faucet.chia.net/ ### 可以同时在旧土地和新地块上耕种吗？ @@ -260,7 +260,7 @@ Each plot NFT you create will require 1 mojo (1 trillionth of a XCH) + transacti Chia has three major differences from most other crypto pooling protocol: -1. Joining pools is permissionless. 在加入之前不需要在耕种池(矿池)服务器上注册账户。 +1. Joining pools is permissionless. 在加入之前不需要在耕种池(矿池)服务器上注册账户。 在加入之前不需要在耕种池(矿池)服务器上注册账户。 2. Farmers receive 1/8 of the block reward plus transaction fees, while the pool receives 7/8 of the reward to redistribute (minus pool fees) amongst all pool participants. 3. The farmer with the winning proof will farm the block, not the pool server. @@ -321,8 +321,8 @@ Python ### How does one calculate a farmer's space? -A farmer's space can be estimated by the number of points submitted over each unit of time, or points/second. 每个k32地块平均每天获得10个积分（points）。 所以每个地块的算力为 `10 / 86400 = 0.0001157 points/second`。 Per byte, that is `L = 0.0001157 / 108884400275 = 1.06259482265 * 10^-15`. To calculate total space `S`, take the total number of points found `P`, and the time period in seconds `T` and do `S = P / (L*T)`. -For example for 340 points in 6 hours, use `P=340, T=21600, L=1.06259482265e-15`, `S = 340/(21600*1.06259482265e-15) = 14,813,492,786,900 bytes`. Dividing by `1024^4` we get `13.4727932044 TiB`. +A farmer's space can be estimated by the number of points submitted over each unit of time, or points/second. 每个k32地块平均每天获得10个积分（points）。 每个k32地块平均每天获得10个积分（points）。 所以每个地块的算力为 `10 / 86400 = 0.0001157 points/second`。 Per byte, that is `L = 0.0001157 / 108884400275 = 1.06259482265 * 10^-15`. Per byte, that is `L = 0.0001157 / 108884400275 = 1.06259482265 * 10^-15`. To calculate total space `S`, take the total number of points found `P`, and the time period in seconds `T` and do `S = P / (L*T)`. +For example for 340 points in 6 hours, use `P=340, T=21600, L=1.06259482265e-15`, `S = 340/(21600*1.06259482265e-15) = 14,813,492,786,900 bytes`. Dividing by `1024^4` we get `13.4727932044 TiB`. Dividing by `1024^4` we get `13.4727932044 TiB`. :::info diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/bridge-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/bridge-guide.md new file mode 100644 index 0000000000..bd82089fee --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/bridge-guide.md @@ -0,0 +1,333 @@ +--- +title: XCH Bridge Guide +slug: /bridge-guide +--- + +## Intro + +A _cryptocurrency bridge_ is a powerful tool that enables seamless transfers of digital assets between different blockchain networks, breaking down the barriers of blockchain interoperability. The first Chia blockchain bridge by Warp.Green is now available, paving the way for anyone to access XCH. + +As the first of many bridges to come, Warp.Green marks an exciting milestone in our journey toward greater access to chia (XCH). To help you get started, here's a introductory guide on how to use the Warp.Green bridge. + +## The Warp.green Bridge + +The [Warp.green bridge](https://www.warp.green/) is a messaging protocol that enables bridging assets between Chia and other blockchains. It is an open-source project located on [GitHub](https://github.com/warpdotgreen). It was developed by Warp.green, which is not affiliated with Chia Network Inc. + +This guide will show you how to send ETH from the [Base](https://www.base.org/) blockchain (an Ethereum L2) to the Chia blockchain. The transfer will take a total of 15-20 minutes, though the initial setup could take considerably longer if you are not familiar with the technologies involved. + +:::info + +It is also possible to bridge assets from Ethereum to Chia, but we chose the Base chain for this guide because it tends to have lower fees. + +In addition, it is possible to bridge assets in the other direction: from Chia to Ethereum/Base. This guide doesn't demonstrate this functionality, but the basic technique is quite similar. + +Finally, note that the bridge is set up to allow for bridging _any_ Chia or Ethereum asset. However, only a limited number of assets are currently supported. A list of supported assets is maintained at [warp.green/bridge/assets](https://www.warp.green/bridge/assets). + +::: + +## Set up MetaMask + +[MetaMask](https://metamask.io/) is one of the most popular wallets for storing digital assets such as ETH, and it supports the Base blockchain. We will use MetaMask for this guide, so if you want to follow along, you will need to install it as a web browser extension. But don't worry – if you want to use a different Base wallet, the instructions will likely be similar. + +After you have installed MetaMask, click the browser extension button ("1" in the following image), then click the dropdown to change blockchains ("2"): + +

+ bridge +

+
+ +By default, Ethereum's mainnet will be selected. The Warp.green bridge _will_ work with this network, but for this guide, we will use Base instead. Click `+ Add network`: + +

+ bridge +

+
+ +Several supported networks will be displayed. Locate `Base Mainnet` and click `Add`: + +

+ bridge +

+
+ +Verify that you are adding the correct network. The Chain ID for the Base mainnet is `8453`. Make sure this number is shown, and click `Approve`: + +

+ bridge +

+
+ +The network should be added successfully. Click `Switch to Base Mainnet`: + +

+ bridge +

+
+ +You will be given some important info about this network. Read this info carefully, then click `Got it`: + +

+ bridge +

+
+ +In order to use this wallet for the bridge, you will need to add funds. In this example, the MetaMask wallet was funded with 0.0057 ETH on the Base blockchain: + +

+ bridge +

+
+ +After your Ethereum wallet has been funded, you can set up a Chia wallet. + +## Set up a Chia wallet + +While several Chia wallets exist, currently the bridge only supports wallets that use WalletConnect, as well as [Goby](https://www.goby.app/). For this example, we will use the Chia reference wallet. See our [wallet guide](/getting-started/wallet-guide/#use-the-chia-wallet) for instructions on setting up this wallet. + +You will need to add some XCH to the reference wallet in order to pay fees. In the image below, the wallet contains 0.001 XCH. Typically, this amount will be sufficient. + +We're going to send a wrapped form of ETH to the Chia reference wallet. If you are using Chia 2.3.1 or later, your wallet will automatically recognize the wrapped ETH, but it's still a good idea to add this asset manually. + +:::info + +Regardless of which blockchain you are using, when you receive a bridged token, it will be a "wrapped" version of the native token. The Warp.green bridge calls its tokens "warped" instead of "wrapped". There is no material difference between these two terms; they can be used interchangeably. + +::: + +Click `MANAGE TOKEN LIST`: + +

+ bridge +

+
+ +Locate `Base Warped milliETH` and click the slider to enable this asset. Feel free to double-check that the asset's ID matches the one from the [asset list](https://www.warp.green/bridge/assets) on Warp.green's website: + +

+ bridge +

+
+ +Your wallet will add `Base Warped milliETH`: + +

+ bridge +

+
+ +:::info + +One `Base Warped milliETH` is the equivalent to 1/1000 of one ETH. This denomination was chosen due to the differences in decimals on Chia and Ethereum. + +::: + +## Connect your wallets to the bridge + +Using the same browser where you installed MetaMask, browse to [warp.green/bridge](https://www.warp.green/bridge). In order to use the bridge, you will need to connect both of your wallets. + +### Connect your ETH wallet + +Click `Connect ETH Wallet`: + +

+ bridge +

+
+ +Click `MetaMask` (or whichever wallet you used on the Ethereum side): + +

+ bridge +

+
+ +Select the account(s) you want to connect to the bridge. If you just installed MetaMask, there will only be one account. Click `Next`: + +

+ bridge +

+
+ +Click `Connect` to connect your MetaMask wallet to the bridge: + +

+ bridge +

+
+ +Your MetaMask wallet is now connected to the bridge. + +### Connect your Chia wallet + +Click `Connect Wallet`: + +

+ bridge +

+
+ +Click `Wallet Connect` if you are using the Chia reference wallet: + +

+ bridge +

+
+ +You will be shown a QR code (not shown here). In this example, we'll click the `Copy Link` button. + +Next, open your reference wallet, click the WalletConnect icon ("1" in the image below), then click `ADD CONNECTION` ("2"): + +

+ bridge +

+
+ +Paste the link you previously copied, and click `CONTINUE`: + +

+ bridge +

+
+ +Your Chia reference wallet will now be connected to the bridge. Click `CLOSE`: + +

+ bridge +

+
+ +The bridge will request an address from your wallet. It may perform other requests as well. Click `CONFIRM` for each request: + +

+ bridge +

+
+ +Return to your web browser. You should see `Connected` displayed under `Wallet Connect`. If so, you can close this dialog: + +

+ bridge +

+
+ +## Initiate the transfer + +The bridge will ask you to enter an amount to transfer. By default, the asset to transfer will be USDC. However, in this example, we will transfer ETH: + +

+ bridge +

+
+ +Enter the amount to transfer. Also, verify that the `From` and `To` chains are accurate. For this example, we will transfer 0.001 ETH from Base to Chia. + +:::info + +The Base blockchain will charge a fee, so you will not be able to send the full amount in your MetaMask wallet. In this example, 0.00000465 ETH was the required fee. This fee will vary, depending on which blockchain you are using, and how busy the network is. + +::: + +After you have verified this info, click `Bridge`: + +

+ bridge +

+
+ +In Step 1 of the transfer, you will be given one more chance to verify the accuracy of everything you have entered. + +:::warning caution + +Be sure to read this dialog carefully, and verify that all information contained within is accurate. + +::: + +:::note note on fees + +Several fees may apply when using the bridge: + +Each blockchain charges a fee to use its network. The size of each fee depends on how busy the network is, as well as how long you are willing to wait for your transaction to be confirmed. Generally speaking, the fees on Base are significantly lower than those on Ethereum. On Chia, the network is often not busy enough to require any fees. + +In addition, a "toll" is automatically deducted for using the bridge. The toll is a small charge (either 0.001 XCH or 0.00001 ETH, depending on the chain where the transaction originated), collected solely to prevent network spam. This money does not go to the bridge or to its operators. Instead, it is redirected to the farmer/miner of the block which includes your transaction. + +Finally, the bridge itself charges a 0.3% tip for using the protocol. This tip is split among the bridge validators and helps to cover the costs associated with maintaining the bridge. + +For more information, see [warp.green's documentation](https://docs.warp.green/). + +::: + +If everything looks good, click `Initiate Bridging`: + +

+ bridge +

+
+ +MetaMask will pop up, and you will be shown the details of your transfer. This includes the current blockchain fee amount. Click `Confirm` to accept the fee and initiate the transfer: + +

+ bridge +

+
+ +You will now be taken to Step 2 of the transfer. Before completing the transfer, you will need to wait around 10-15 minutes; the exact time can vary a bit. The reason for this delay is to avoid funds being lost in blockchain reorgs: + +

+ bridge +

+
+ +Leave this browser window open, and return to it after 15 minutes. + +### Complete the transfer + +After waiting for around 15 minutes, the transfer will reach Step 3. Click `Generate Offer via Wallet`: + +

+ bridge +

+
+ +Change to your Chia reference wallet. You may see a dialog asking for permission to execute `getWallets`. If so, Click `CONFIRM`: + +

+ bridge +

+
+ +You may need to grant permission to execute one or more additional methods. Click `CONFIRM` on these dialogs. Eventually, you will see a dialog with a `SHOW OFFER DETAILS` button. Click this button: + +

+ bridge +

+
+ +You will be shown the details of the transfer from the bridge to your wallet. By default, no blockchain fee will be used. However, if you have available funds (the small circle in the image below), we recommend that you add a fee in order to expedite the transfer. Either way, leave the `In exchange for` side of the dialog blank. Click `CLOSE` when you are finished reviewing this dialog: + +

+ bridge +

+
+ +If you added a blockchain fee, it will now appear in the `Confirmation Request` dialog. Click `CONFIRM`: + +

+ bridge +

+
+ +Return to your web browser. The transfer will now be in progress. This should be completed in 1-5 minutes, depending on how busy the Chia network is, along with the size of your fee: + +

+ bridge +

+
+ +After the transfer has completed, return to the reference wallet. It should now contain the `Base Warped milliETH`. In this example, the bridge charged a 0.3% fee, so 0.997 wmilliETH.b was transferred. Recall that this amount is worth 0.000997 ETH: + +

+ bridge +

+
+ +Congratulations! You have successfully transferred ETH from the Base chain to Chia. If you would like to exchange the wmilliETH.b for another asset, you could head to a decentralized exchange such as [dexie.space](https://dexie.space/), or an AMM such as [tibetswap.io](https://v2.tibetswap.io/). diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md index d37da76cab..b169488e45 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md @@ -6,9 +6,6 @@ slug: /farming-guide import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -import WalletKeyDetails from '@site/static/img/troubleshooting/wallet_key_details.png'; -import WalletKeysPublic from '@site/static/img/faq/wallet_keys_public_key.png'; -import WalletLogout from '@site/static/img/troubleshooting/wallet_logout.png'; So you want to be a Chia farmer? You've come to the right place! @@ -66,8 +63,7 @@ In order to store the blockchain database, an SSD with at least 520 MB/s read/wr :::info -Let's say you have a computer without much free space. If you add a 1024-GB external SSD, it will be sufficient to create and store a plot, as well as to store the blockchain database. This will not be an ideal setup for -creating a larger farm. But if you already have this equipment, you can set up a small farm without spending any money. +Let's say you have a computer without much free space. If you add a 1024-GB external SSD, it will be sufficient to create and store a plot, as well as to store the blockchain database. This will not be an ideal setup for creating a larger farm. But if you already have this equipment, you can set up a small farm without spending any money. ::: @@ -82,6 +78,7 @@ Two check boxes will be shown on the last screen after the install has completed
Check both boxes
+
## Run and configure Chia @@ -91,6 +88,7 @@ The first time Chia starts, you will be given the option to run in either Wallet
Choose farming mode
+
### Create a wallet @@ -100,21 +98,23 @@ Assuming you don't have a wallet yet, click `CREATE A NEW WALLET KEY` (If you al
Create a new wallet key
+
-You will be presented with a list of twenty-four words. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is also important. +You will be presented with a list of twenty-four words. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is important. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is also important. -You can also choose a custom name for your wallet. Click `NEXT` when you are finished. +You can also choose a custom name for your wallet. Click `NEXT` when you are finished. Click `NEXT` when you are finished. :::warning -If someone obtains a copy of these words, they can steal your entire wallet, including all of its funds. Be sure to store your recovery phrase in a safe place. +If someone obtains a copy of these words, they can steal your entire wallet, including all of its funds. Be sure to store your recovery phrase in a safe place. Be sure to store your recovery phrase in a safe place. -::: +:::
Wallet seed phrase
+
You will be taken to your wallet, which will show a zero-XCH balance. There will be two round icons in the upper-right corner, one for the full node and one for the wallet: @@ -125,14 +125,14 @@ You will be taken to your wallet, which will show a zero-XCH balance. There will
Zero wallet balance
+
### Fund your wallet If you think you will ever want to join a pool (recommended for small and medium farms), you will need at least one mojo (one trillionth of an XCH). To help with this, we have set up an online faucet at [faucet.chia.net](https://faucet.chia.net/). -To use the faucet you will need to identify your **Master Public Key** (also referred to as the **Public Key**). -You can use either the GUI or CLI to identify the Master Public Key by following these steps: +To use the faucet you will need to identify your **Master Public Key** (also referred to as the **Public Key**). You can use either the GUI or CLI to identify the Master Public Key by following these steps: #### GUI @@ -191,7 +191,7 @@ For more security best practices please review the [Securing Your Chia – How t :::info -You can continue with this guide while waiting for your faucet payment to arrive. +You can continue with this guide while waiting for your 100 mojos to arrive. ::: @@ -202,6 +202,7 @@ Click the `Full Node` icon on the left side of your wallet:
Syncing from genesis
+
This screen shows your node's syncing status. In order to farm Chia, your node needs to be fully synced. You have two options to achieve this: @@ -252,11 +253,12 @@ Click the `Pooling` icon on the left side of your wallet, and click `JOIN A POOL
Join a pool
+
Before you can join a pool, you will need to create a plot NFT. This will allow you to easily change pools later. -Select `Connect to pool`. You will need to enter a valid pool URL. We will use OpenChia for this example, but there are many great pools to choose from. For a list of reputable pools, see [Chialinks.com](https://chialinks.com/pools/). (Chia Network Inc. does not run a pool, and is not affiliated with OpenChia or Chialinks). +Select `Connect to pool`. You will need to enter a valid pool URL. We will use OpenChia for this example, but there are many great pools to choose from. `Connect to pool` -- You will need to enter a valid pool URL. We will use OpenChia for this example, but there are many great pools to choose from. For a list of reputable pools, see [Chialinks.com](https://chialinks.com/pools/). (Chia Network, Inc. does not run a pool, and is not affiliated with OpenChia or Chialinks). (Chia Network Inc. does not run a pool, and is not affiliated with OpenChia or Chialinks). :::info @@ -264,11 +266,12 @@ If you don't want to join a pool, select `Self pool`. This will assign you to a ::: -Creating a plot NFT requires an on-chain transaction that will cost one mojo. You are also recommended to enter a blockchain fee. If you used the faucet, you will now have 100 mojos. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes. +Creating a plot NFT requires an on-chain transaction that will cost one mojo. You are also recommended to enter a blockchain fee. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes. You are also recommended to enter a blockchain fee. If you used the faucet, you will now have 100 mojos. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes.
Create a plot NFT
+
:::info @@ -279,18 +282,20 @@ If your faucet payout has not arrived after more than 10 minutes, someone on [Di ::: -If you entered a valid pool URL, the details will pop up. For example, this pool has a fee of 1%. If everything looks acceptable, click `CREATE`: +If you entered a valid pool URL, the details will pop up. For example, this pool has a fee of 1%. If everything looks acceptable, click `CREATE`: For example, this pool has a fee of 1%. If everything looks acceptable, click `CREATE`:
Pool details
+
-Your transaction will be pushed to the blockchain. While it is pending, a new screen will appear: +Your transaction will be pushed to the blockchain. While it is pending, a new screen will appear: While it is pending, a new screen will appear:
Plot NFT pending
+
After the transaction has been finalized (typically 1-3 minutes), the details of your plot NFT will appear: @@ -298,6 +303,7 @@ After the transaction has been finalized (typically 1-3 minutes), the details of
Plot NFT details
+
A two-word name will automatically be assigned to your plot NFT, in this case "Harlequin Koala". In order to determine how much space you are contributing, your pool will periodically send you challenges. If you want to change pools later, simply return to this screen and click `CHANGE POOL`. @@ -325,6 +331,7 @@ From the Chia application, click the `Farm` icon and click `ADD A PLOT`:
Add a plot
+
If you previously created a plot NFT, it will show up now. The plots you create will be associated with this NFT. It is important that you associate all of your plots to the same NFT in order to farm to a pool, as well as to be able to change pools easily if desired. As long as your plot NFT shows up here, there is no need to change it: @@ -332,6 +339,7 @@ If you previously created a plot NFT, it will show up now. The plots you create
Plot NFT
+
Next, you will need to choose a plotter. When creating a single plot, `Chia Proof of Space` and `madMAx` both will work on almost all hardware. The plot from this example was created with `madMAx` because it requires the smallest amount of temporary disk space. @@ -340,18 +348,20 @@ Next, you will need to choose a plotter. When creating a single plot, `Chia Proo When building a larger farm, the plotter you choose will depend greatly on your available hardware. It may help to experiment with multiple plotters to get a feel for which ones work best for your setup. For details on each of the available plotters, see our [Plotting Software](/plotting-software) section. -::: +:::
Choose plotter
+
For the `Keys` section, you typically won't need to change anything.
- Keys + 密钥
+
Next, you will need to choose a `k` value, and possibly a compression level. @@ -371,6 +381,7 @@ Certain plotters are also capable of creating compressed plots, which are discus
Choose K value
+
Next, you need to select the temporary and final directories for your plot. The medium for temporary storage will greatly affect the speed at which your plot is created: @@ -379,7 +390,7 @@ Next, you need to select the temporary and final directories for your plot. The - **SSD** -- Most farmers choose to use an enterprise NVMe SSD for the temporary storage. These SSDs can handle large amounts of reads and writes in their lifetimes. - **HDD** -- If you don't mind plotting slowly, you can choose a directory located on an HDD. -The final directory is where the plot will be copied after it has been created. Most farmers will choose to use an HDD as the final directory. However, for this tutorial an NVMe SSD was used for both the temporary and final directories. +The final directory is where the plot will be copied after it has been created. The final directory is where the plot will be copied after it has been created. Most farmers will choose to use an HDD as the final directory. However, for this tutorial an NVMe SSD was used for both the temporary and final directories. :::warning @@ -392,13 +403,15 @@ You will also need to choose how many plots to create. Certain plotters can be o
Temporary and final directories
+
-After you have gone through all of these settings, click `CREATE`. You will be taken to a progress panel: +After you have gone through all of these settings, click `CREATE`. You will be taken to a progress panel: You will be taken to a progress panel:
Plot creation progress
+
The amount of time required to create this plot is highly dependent on your hardware. The world record time to create a k32 plot is around 30 seconds. The plot for this tutorial was created on a laptop in around 3 hours. @@ -418,6 +431,7 @@ Before you can begin farming, you need to be running a synced full node. Earlier
Synced node
+
Your node is now synced. If your plot has finished being created, you are also farming. To verify this, click the `Farm` icon: @@ -425,6 +439,7 @@ Your node is now synced. If your plot has finished being created, you are also f
Farm health
+
You will be shown a number of details about your farm. As long as the `Farm Health` section has all green icons, everything is working as expected. @@ -445,7 +460,7 @@ Once you have a small farm up and running, you can decide whether to expand, and - [Notes about SSD encurance](/ssd-endurance) - [How to move plots](/moving-plots) to their final destinations -## How to Get Help +## 如何获得帮助 - Get help on CNI's official [Discord](https://discord.gg/chia), in the `#farming-and-plotting` and `#support` channels. -- Get more questions answered in the [plotting FAQ](/plotting-faq). +- 在[生成地块问答](/plotting-faq)中获取更多问题的解答。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md index e31ecc85d3..38733f2bad 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md @@ -8,13 +8,13 @@ import TabItem from '@theme/TabItem'; :::info -This page will go into the details of the various different ways to install Chia. If you already installed Chia as part of the Farming Guide, then feel free to skip ahead to the [Plotting Basics](/plotting-basics) page. +This page will go into the details of the various different ways to install Chia. This page will go into the details of the various different ways to install Chia. If you already installed Chia as part of the Farming Guide, then feel free to skip ahead to the [Plotting Basics](/plotting-basics) page. ::: There are various ways to install Chia, with the best method depending on what you intend to do: -- If you simply wish to use the Chia wallet, or to run a farm on a single personal computer, then we recommend installing the GUI from our [official downloads page](https://www.chia.net/downloads) for Windows and MacOS, and for Linux users to install the package [as described below](#using-the-cli). The GUI is the simplest way to interact with the Chia client and ideal for most non-developer use cases. +- If you simply wish to use the Chia wallet, or to run a farm on a single personal computer, then we recommend installing the GUI from our [official downloads page](https://www.chia.net/downloads) for Windows and MacOS, and for Linux users to install the package [as described below](#using-the-cli). The GUI is the simplest way to interact with the Chia client and ideal for most non-developer use cases. The GUI is the simplest way to interact with the Chia client and ideal for most non-developer use cases. - If you intend to run a dedicated Chia full node on a server and connect to it programmatically using the [RPC interface](/rpc), the best method would be to install and run Chia via the command line on a proper server environment. @@ -38,7 +38,7 @@ Chia plot files are at least 108GB in size (for K32). To plot successfully requi ### Sleep kills plots -If the computer or hard drives go to sleep during the plotting process, it will fail, and you will need to start over. Please ensure all sleep, hibernate and power saving modes for your computer and hard drives are disabled before starting the Chia plotting process. In the future, Chia will have a resume plot feature. In the meantime, if you do get a failed plot, delete all `*.tmp` files before starting a new plot. +If the computer or hard drives go to sleep during the plotting process, it will fail, and you will need to start over. Please ensure all sleep, hibernate and power saving modes for your computer and hard drives are disabled before starting the Chia plotting process. In the future, Chia will have a resume plot feature. In the meantime, if you do get a failed plot, delete all `*.tmp` files before starting a new plot. Please ensure all sleep, hibernate and power saving modes for your computer and hard drives are disabled before starting the Chia plotting process. In the future, Chia will have a resume plot feature. In the meantime, if you do get a failed plot, delete all `*.tmp` files before starting a new plot. --- @@ -110,7 +110,7 @@ sudo dnf install chia-blockchain :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Create virtual environment @@ -146,7 +146,35 @@ values={[ :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: + +```bash +# Download chia-blockchain +git clone https://github.com/Chia-Network/chia-blockchain -b latest --recurse-submodules + +# Change directory +cd chia-blockchain + +# Install dependencies +sh install.sh + +# Activate virtual environment +. ./activate + +# Initialize +chia init +``` + +The following is how you update to the latest version: + +```bash +# Change directory +cd chia-blockchain + +# Activate the virtual environment +. :::note +Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. +::: ```bash # Download chia-blockchain @@ -197,6 +225,10 @@ sh install.sh # Activate the virtual environment . ./activate +# Initialize the new version +chia init +``` ./activate + # Initialize the new version chia init ``` @@ -206,7 +238,7 @@ chia init :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Download chia-blockchain @@ -240,6 +272,9 @@ chia stop -d all # Deactivate the virtual environment deactivate +# Remove the current virtual environment +rm -r venv + # Pull the latest version git fetch git checkout latest @@ -426,6 +461,16 @@ See [install from source](/installation#from-source) for detailed instruction. #### Install from binary package +```bash +# Install chia-blockchain as a binary package +python -m venv venv +ln -s venv/bin/activate +. #### Install from source - Amazon Linux 2 + +See [install from source](/installation#from-source) for detailed instruction. + +#### Install from binary package + ```bash # Install chia-blockchain as a binary package python -m venv venv @@ -552,19 +597,136 @@ pkg install screen tmux git clone https://github.com/Chia-Network/chia-blockchain.git -b latest # or with SSH: git clone git@github.com:Chia-Network/chia-blockchain.git -b latest -# Note: you can specify the branch by adding "--branch " like: git clone http://github.com/Chia-Network/chia-blockchain.git --branch 1.0.1 +# Note: you can specify the branch by adding "--branch Now, activate the newest environment (`. venv/bin/activate`), upgrade pip (`pip install --upgrade pip`). Now you may skip down to the [clvm_rs install section](#clvm_rs) and begin there. + +---==crwdHRulesLBB_2_BBsuleRHdwrc== + +#### Why This Manual Installation? + +Currently the only way to ensure Chia builds on FreeBSD is to do it from the source. By following these instructions to the letter, you should have no problem building the latest Chia from source on a FreeBSD 11.3 or 11.4. This should also work on FreeBSD 12, possibly with some modifications - e.g. if the ports py-cryptography version is newer than 3.3.2, simply edit as needed - or if your preferred Python version is 3.8+ it should all still work considering you modify the package names as necessary. + +#### Notes on FreeNAS (TrueNAS) + +If you had been using NFS or Samba sharing to expose your plots to a harvester on another OS, such as Linux, you can instead build Chia within a jail (see the FreeNAS manual for 'jails'), expose your plot directories to it and run the harvester within. In my experience, it provides lower-latency and more reliable access to the plots since the disks are direct-attached and not being provided through an extra few layers of network protocols. + +If you are using a fresh jail created by the FreeNAS web GUI you may need to install openssh and setup a ssh key to login as root because by default it appears PAM password logins do not work. The jail shell CLI provided by the FreeNAS GUI allows copy and pasting so you can easily paste your public-key into /root/.ssh/authorized_keys && chmod -R 700 /root/.ssh. + +These instructions would be applicable to 11.3 and 11.4 jails created within FreeNAS 11 only. Version 12 (FreeBSD 12) ✔ + +#### Other Notes + +These instructions will have you building both chia-blockchain and clvm_rs from github source, and python-cryptography from FreeBSD's ports. + +The result of this build will be the "chia version" showing the current release branch ahead by 1 and in "dev0"; for instance building 1.0.1 results in "chia version" returning "1.0.2.dev0". If someone knows why this is and how to fix it, please, edit and correct this! It does not happen on Linux. + +_**These instructions assume a fresh FreeBSD 11 installation!**_ + +#### Discouraged? + +Following the instructions in this document will result in a working Chia CLI build on FreeBSD 11 if you follow step-by-step starting from a vanilla FreeBSD installation. Is something broken? Compare the commands you typed, accessible in your **bash** shell history, and match them with each command in this document. If you feel you've messed something up, do the following: +``` +# if you have (venv) in your shell prompt, type deactivate +deactivate +# remove the chia-blockchain directory which will contain clvm_rs and the Python venv +rm -rf chia-blockchain +# ... now start again! You don't need to do all the setup steps but instead may start at the upgrade notes above if you had finished up to the py-cryptography ports build. ``` -Create a virtual environment directory 'venv' from _within_ the 'chia-blockchain' directory and activate it before proceeding +#### Pre-requisite package installation + +_If starting the build again after a failure and you have not re-installed FreeBSD, don't just skip this package installation section! You may have missed one or more software packages critical to the build._ + +The 'pkg', 'portsnap' and port build are to be run as root. Everything else can be run from a normal non-root user. + +As root, update pkg and ports, and then install all packages as instructed below. ``` -cd chia-blockchain -python3 -m venv venv -source venv/bin/activate +# Update your packages and ports; if ports are already installed as part of your fresh install run portsnap update instead of fetch/extract. +pkg update +portsnap fetch && portsnap extract + +# Install bash if you have not; the default csh will not suffice for the build scripts. +pkg install bash +# change your shell to bash +chsh -s /usr/local/bin/bash +# run bash +/usr/local/bin/bash ``` -You are now in the virtual environment that Python (and so chia) will use. You should have a "(venv)" prefix to your terminal prompt to confirm the venv is working. +Make sure you change the shell for your non-root chia-blockchain user. If you're opting to run Chia as root, you can skip this. If you are root, run this as it appears below; otherwise, you can omit the username because you are already that user. + +``` +chsh -s /usr/local/bin/bash NONROOT_USERNAME +``` + +Now proceed with installing the mandatory development tools. + +``` +pkg install lang/gcc9 gcc gmake cmake + +``` + +#### gcc notes + +After installing gcc version 9.0, this message appears: + +``` +To ensure binaries built with this toolchain find appropriate versions +of the necessary run-time libraries, you may want to link using + + -Wl,-rpath=/usr/local/lib/gcc9 +``` + +It's probably possible to build the libraries in a way that doesn't require `export LD_LIBRARY_PATH=/usr/local/lib/gcc9`. If you know how click "edit" and dish. + +#### Install rust, Python, and everything else. + +``` +pkg install lang/rust +pkg install lang/python37 py37-pip py37-setuptools py37-wheel py37-sqlite3 py37-cffi py37-virtualenv py37-maturin python +pkg install node npm git openssl +``` + +If you are ssh'ing into the machine you might want to use 'screen' so that processes will continue even if you logout. For more information: https://www.freebsd.org/cgi/man.cgi?query=screen. 'tmux' is also a great alternative especially if you use iTerm2 on macOS as it supports native tabs and windows with the '-CC' CLI option. + +``` +# optional packages +pkg install screen tmux +``` + +#### Repo Cloning and Virtual Environment (venv) Activation + +**From this point on, with the exception of the security/py-cryptography port build process (and any other exceptions noted), you may proceed as a normal user.** + +``` +# Clone the latest chia-blockchain repository, via HTTP: +git clone https://github.com/Chia-Network/chia-blockchain.git -b latest +# or with SSH: +git clone git@github.com:Chia-Network/chia-blockchain.git -b latest +# Note: you can specify the branch by adding "--branch :::note +Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. +::: + +```bash +# Download chia-blockchain +git clone https://github.com/Chia-Network/chia-blockchain -b latest --recurse-submodules + +# Change directory +cd chia-blockchain + +# Checkout the beta or release candidate by tag, tags can be found https://github.com/Chia-Network/chia-blockchain/tags. +git checkout tags/2.1.2-rc2 + +# Install dependencies +./Install.ps1 + +# Activate virtual environment +. ./venv/Scripts/Activate.ps1 + +# Initialize +chia init +``` You should have a "(venv)" prefix to your terminal prompt to confirm the venv is working. Upgrade pip: @@ -692,7 +854,7 @@ sed -i .bak 's/enable_upnp: True/enable_upnp: False' ~/.chia/mainnet/config/conf While you don't absolutely need port 8444 forwarded to your Chia node, it is advised that you do so that other peers may connect to you instead of you solely connecting to them. For the average at-home farmer it is advised you do not disable UPnP unless you absolutely know what you're doing or have another node on your local network already using the port and are planning to [Farm on Many Machines](https://docs.chia.net/farming-on-many-machines/). -\*\*\*==crwdHRulesLBB_2_BBsuleRHdwrc== +---==crwdHRulesLBB_2_BBsuleRHdwrc== #### Installed and Ready to Farm! @@ -813,6 +975,211 @@ The GUI can now be launched using the following commands: cd chia-blockchain . ./activate +cd chia-blockchain-gui +npm run electron +``` ./venv/bin/activate +pip install --upgrade pip + +cd ../chiavdf/ +pip install . + +cd ../maturin/ +# don't pass static compiler flags to the rust linker because that would cause +# a core dump, possibly because of resource limits +sed -i 's|cargo_args.extend(\["--", "-C", "link-arg=-s"\])|#cargo_args.extend(\["--", "-C", "link-arg=-s"\])|' setup.py +pip install . + +cd ../clvm_rs/ +maturin develop --release + +# XXX should be a more elegant way... +" like: git clone http://github.com/Chia-Network/chia-blockchain.git --branch 1.0.1 + +``` + +Create a virtual environment directory 'venv' from _within_ the 'chia-blockchain' directory and activate it before proceeding + +``` +cd chia-blockchain +python3 -m venv venv +source venv/bin/activate +``` + +You are now in the virtual environment that Python (and so chia) will use. You should have a "(venv)" prefix to your terminal prompt to confirm the venv is working. + +Upgrade pip: + +``` +pip install --upgrade pip +``` + +To exit the virtual environment: + +``` +deactivate +``` + +#### Building py-cryptography from ports + +_**You'll need to switch to root for this part. If you're already using root remember to leave the virtual environment for this step.**_ + +``` +cd /usr/ports/security/py-cryptography + +# Instruct 'make' that the SSL library is openssl. +# Also force the Python version in case the port tries for a higher one +echo "DEFAULT_VERSIONS+=ssl=openssl python=3.7 python3=3.7" >> /etc/make.conf + +make +``` + +You'll probably see a bunch of warnings and notices; these are not errors and it will build. + +Do NOT run make install. We will do our own py-cryptography install because 'make install' does not copy to our virtual environment. (If you know how to change this, please edit). + +If you are running inside a jail and make fails with an error about the OSVERSION not matching UNAME, you will need to set the UNAME_r environment variable to match your jails OSVERSION: + +``` +# Adjust the value to match your jails OSVERSION +export UNAME_r=11.4-RELEASE +``` + +A full version list can be found [here](https://docs.freebsd.org/en/books/porters-handbook/book.html#versions). + +Once complete switch back to your non-root user if you so optioned. You must now be in your venv once again. + +#### clvm_rs + +Build and install the current version of [clvm_rs](https://github.com/Chia-Network/clvm_rs). +These instructions were created for version 0.1.7 but a newer version may exist. + +``` +git clone http://github.com/Chia-Network/clvm_rs.git --branch 0.1.7 +cd clvm_rs +maturin develop --release +pip install git+https://github.com/Chia-Network/clvm@use_clvm_rs +``` + +clvm_rs 0.1.7 is now installed in your virtual environment. + +#### Install py-cryptography to the venv + +Copy py-cryptography and its meta-data from the staging directory to your virtual environment: + +``` +cp -R /usr/ports/security/py-cryptography/work-py37/stage/usr/local/lib/python3.7/site-packages/cryptography ${VIRTUAL_ENV}/lib/python3.7/site-packages/cryptography +cp -R /usr/ports/security/py-cryptography/work-py37/stage/usr/local/lib/python3.7/site-packages/cryptography-3.3.2-py3.7.egg-info ${VIRTUAL_ENV}/lib/python3.7/site-packages/cryptography-3.3.2-py3.7.egg-info +``` + +Clear any Python byte-code cache files that may contain the old path. These should be re-built by the interpreter but we like a clean environment. + +``` +find ${VIRTUAL_ENV}/lib/python3.7/site-packages/cryptography -name __pycache__ | xargs -I{} rm -rf "{}" +``` + +#### Chia modifications and Building Chia Itself + +Switch to your chia-blockchain clone directory. You will need to edit two files. + +Using your favorite text editor, modify setup.py to edit the cryptography package version to 3.3.2. + +``` +"cryptography==3.4.6" --> to --> "cryptography==3.3.2" +``` + +Now you must modify chia/util/keychain.py to provide a static key when using the Python keyring. This is mandatory otherwise every time the keyring is accessed your passphrase will need to be entered on the command line, and for the CLI daemon this will not do. + +On line 25 of chia/util/keychain.py, change: + +``` +elif platform=="linux": +``` + +to: + +``` +elif platform=="linux" or platform.startswith("freebsd"): +``` + +On line 27 of the same file, change the passphrase from "your keyring password" to whatever you wish your passphrase to be. This is intended to be fixed in future versions but, for the time being, Linux and FreeBSD must have the keyphrase provided statically. + +``` +keyring.keyring_key = "your keyring password" # type: ignore +``` + +can be changed like so: + +``` +keyring.keyring_key = "Too Many Secrets" +``` + +Now, you will build Chia! + +``` +sh install.sh +``` + +Once done, run: + +``` +chia init +``` + +NOTE: if you need to disable UPnP - a protocol which automatically sets up port-forwarding on routers using NAT which is a typical setup at any residence with broadband - set "enable_upnp: False" in config.yaml. You can use the one-liner below or do it yourself. + +``` +sed -i .bak 's/enable_upnp: True/enable_upnp: False' ~/.chia/mainnet/config/config.yaml +``` + +While you don't absolutely need port 8444 forwarded to your Chia node, it is advised that you do so that other peers may connect to you instead of you solely connecting to them. For the average at-home farmer it is advised you do not disable UPnP unless you absolutely know what you're doing or have another node on your local network already using the port and are planning to [Farm on Many Machines](https://docs.chia.net/farming-on-many-machines/). + +\*\*\*==crwdHRulesLBB_2_BBsuleRHdwrc== + +#### Installed and Ready to Farm! + +That's it! Provided the instructions were followed to the T, and the build is a fresh FreeBSD 11.3 or 11.4, either hardware or FreeNAS jailed, you should be good to go! Now go to town with `chia start node` or whatever floats your boat. + +More details can be found in the [Chia Introduction](https://docs.chia.net/introduction). + +_WARNING: Although the following steps have been used successfully, the resulting GUI will be run with an older version of electron than is recommended by the Chia Network team. This may result in unexpected problems._ + +#### Prerequisite package installation + +As root (or using doas / sudo), first install some additional OpenBSD packages required for GUI usage: + +```bash +pkg_add -i electron +``` + +#### Build + +```bash +cd chia-blockchain +. ./activate + +cd chia-blockchain-gui + +# build / set up GUI +npm run build + +# Remove failed electron 8.2.5 install and fall back to the OpenBSD +# ports tree 8.2.0 electron, which currently (as of 6/10/2020) works. +# +# This may not continue to work in the future. A full solution to +# this requires official OpenBSD electron builds, provided by the +# electron project itself. + +rm -rf node_modules/electron +``` + +#### Launch GUI + +The GUI can now be launched using the following commands: + +```bash +cd chia-blockchain +. ./activate + cd chia-blockchain-gui npm run electron ``` @@ -868,6 +1235,14 @@ This can be done by running the following command: export PATH=/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon:$PATH ``` +To load this on startup, add it to the `.bashrc`, `.bash_profile`, or `.zshrc` file depending on which is used by the shell. + +This can be done by running the following command: + +```bash +export PATH=/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon:$PATH +``` + To load this on startup, add it to the `.bashrc`, `.bash_profile`, or `.zshrc` file depending on which is used by the shell. @@ -998,9 +1373,9 @@ chia start farmer ### Systemd -Linux users who have installed the `chia-blockchain-cli` package using [apt, yum, or dnf](https://docs.chia.net/installation/#using-the-cli) will receive systemd configuration files for initializing and managing the Chia processes. Each Chia service needs to be managed separately with systemd, except for the chia-daemon, which will be initialized automatically when any other Chia service is started with systemd (for example, the data-layer service will not automatically start the wallet service - both need to be started individually with systemd). A user must be specified during the initialization to ensure the resulting process can find the Chia root directory. The included systemd files support the default Chia directory location of `/home//.chia/mainnet` only. +Linux users who have installed the `chia-blockchain-cli` package using [apt, yum, or dnf](https://docs.chia.net/installation/#using-the-cli) will receive systemd configuration files for initializing and managing the Chia processes. Each Chia service needs to be managed separately with systemd, except for the chia-daemon, which will be initialized automatically when any other Chia service is started with systemd (for example, the data-layer service will not automatically start the wallet service - both need to be started individually with systemd). A user must be specified during the initialization to ensure the resulting process can find the Chia root directory. The included systemd files support the default Chia directory location of `/home//.chia/mainnet` only. Each Chia service needs to be managed separately with systemd, except for the chia-daemon, which will be initialized automatically when any other Chia service is started with systemd (for example, the data-layer service will not automatically start the wallet service - both need to be started individually with systemd). A user must be specified during the initialization to ensure the resulting process can find the Chia root directory. The included systemd files support the default Chia directory location of `/home//.chia/mainnet` only. -To start a Chia process with systemd, the command format is `systemctl start chia-@`. For example, if starting a Chia full node for the Linux user `ubuntu`, the command would be: +To start a Chia process with systemd, the command format is `systemctl start chia-@`. For example, if starting a Chia full node for the Linux user `ubuntu`, the command would be: For example, if starting a Chia full node for the Linux user `ubuntu`, the command would be: ``` systemctl start chia-full-node@ubuntu @@ -1031,10 +1406,10 @@ Note that the `chia-timelord` service runs the timelord coordinator service, but ## Troubleshooting -Sometimes stray daemons left over from previously running processes will cause strange bugs/errors when upgrading to a new version. Make sure all daemons and chia processes are killed before installing or upgrading. +Sometimes stray daemons left over from previously running processes will cause strange bugs/errors when upgrading to a new version. Make sure all daemons and chia processes are killed before installing or upgrading. Make sure all daemons and chia processes are killed before installing or upgrading. This is normally done by executing `chia stop -d all` from the upgrade example above. -But it doesn't hurt to double check using `ps -Af | grep chia` to make sure there are no chia processes left running. You may have to manually kill the chia daemon if an install and chia start was performed without first running `chia stop -d all` +But it doesn't hurt to double check using `ps -Af | grep chia` to make sure there are no chia processes left running. You may have to manually kill the chia daemon if an install and chia start was performed without first running `chia stop -d all` You may have to manually kill the chia daemon if an install and chia start was performed without first running `chia stop -d all` If all else fails, rebooting the machine and restarting the chia daemon/processes usually does the trick. @@ -1042,7 +1417,7 @@ If all else fails, rebooting the machine and restarting the chia daemon/processe To join a testnet, follow the instructions on [How to Join the Official Testnet](/testnets#join-the-official-testnet). -It is recommended that you keep a separate testnet environment by prepending `CHIA_ROOT="~/.chia/testnetx"` to all of your cli commands. For example, `CHIA_ROOT="~/.chia/testnet10" chia init`. An easier way to do this is to run `export CHIA_ROOT="~/.chia/testnet10"` so that all commands will use testnet10 instead of mainnet. If you're using a version above 1.2.11, you can update all config values to the testnet values by running `chia configure -t true`. +It is recommended that you keep a separate testnet environment by prepending `CHIA_ROOT="~/.chia/testnetx"` to all of your cli commands. For example, `CHIA_ROOT="~/.chia/testnet10" chia init`. An easier way to do this is to run `export CHIA_ROOT="~/.chia/testnet10"` so that all commands will use testnet10 instead of mainnet. If you're using a version above 1.2.11, you can update all config values to the testnet values by running `chia configure -t true`. For example, `CHIA_ROOT="~/.chia/testnet11" chia init`. An easier way to do this is to run `export CHIA_ROOT="~/.chia/testnet11"` so that all commands will use testnet11 instead of mainnet. You can update all config values to the testnet values by running `chia configure -t true`. ## Beta and release candidate installations @@ -1060,7 +1435,7 @@ values={[ :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Download chia-blockchain @@ -1087,7 +1462,7 @@ chia init :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Download chia-blockchain @@ -1112,9 +1487,17 @@ chia init -### Apt +### From packaged installer + + + -```bash # Install packages sudo apt-get update sudo apt-get install ca-certificates curl gnupg @@ -1123,11 +1506,40 @@ sudo apt-get install ca-certificates curl gnupg curl -sL https://repo.chia.net/FD39E6D3.pubkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/chia.gpg # Set up repository -echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/prerelease/debian/ prerelease main" | sudo tee /etc/apt/sources.list.d/chia-blockchain-prerelease.list > /dev/null +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/prerelease/debian/ prerelease main" | sudo tee /etc/apt/sources.list.d/chia-blockchain-prerelease.list > /dev/null sudo apt-get update # Install chia-blockchain sudo apt-get install chia-blockchain # Use chia-blockchain-cli instead for CLI only + + + + +:::note +Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. +::: + +```bash +# Download chia-blockchain +git clone https://github.com/Chia-Network/chia-blockchain -b latest --recurse-submodules + +# Change directory +cd chia-blockchain + +# Checkout the beta or release candidate by tag, tags can be found https://github.com/Chia-Network/chia-blockchain/tags. +git checkout tags/2.1.2-rc2 + +# Install dependencies +sh install.sh + +# Activate virtual environment +. ./activate + +# Initialize +chia init ``` + + + diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/introduction.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/introduction.md index 67623933b5..c8dfa420df 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/introduction.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/introduction.md @@ -12,7 +12,7 @@ Chia是一种具有智能交易能力的加密货币和区块链。 它从头开 Chia的主网于2021年3月19日推出。 其生态系统的开发正在进行中，已发布了[CAT](https://chialisp.com/cats)、[NFT](https://chialisp.com/nfts)、[报价（offer）](https://chialisp.com/offers) 和 [DID](https://chialisp.com/dids) 等基础设施。 -This page will give a brief overview of Chia and its various components. If you are interested in becoming a Chia farmer, feel free to skip ahead to the [Beginner's Guide to Farming](/farming-guide). +This page will give a brief overview of Chia and its various components. This page will give a brief overview of Chia and its various components. If you are interested in becoming a Chia farmer, feel free to skip ahead to the [Beginner's Guide to Farming](/farming-guide). ## 时空证明（Proof of Space and Time） @@ -30,7 +30,7 @@ Chia使用硬币模型来跟踪网络的状态。 在这个模型中，硬币（ 有关更多信息，请查看[硬币模型简介页面](/coin-set-intro)和[Chialisp.com](https://chialisp.com) 网站。 ::: -## Pooling +## 矿池（Pooling） 与许多其他区块链一样，Chia允许连接矿池来确保小规模的农民能够平滑的获得奖励。 然而，Chia的矿池协议具有三个独特的特点。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/testnets.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/testnets.md index 44cb130fc7..d36b4b1a6c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/testnets.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/testnets.md @@ -5,8 +5,11 @@ slug: /testnets :::note -Testnet 10 is the supported testnet. Testnet 7 may remain active, but is no longer officially supported by Chia Network Inc. +Testnet 10 is the supported testnet. + +Testnet 7 may remain active, but is no longer officially supported by Chia Network Inc. Testnets can be used to test the chia software with coins that have no real world value.\ +If you want to run the Chia blockchain mainnet, use the [mainnet installation](/installation) instructions.\ If you want to run the Chia blockchain mainnet, use the [mainnet installation](/installation) instructions. ::: @@ -40,8 +43,12 @@ This step is optional, but it will speed up syncing with the testnet - Linux users: `wget https://databases.chia.net/file/chia-public-databases/blockchain_v2_testnet10.sqlite.gz` while in the directory (a v1 DB is also available, but no longer updated). - Windows users: download it from [https://downloads.chia.net/testnet10/](https://downloads.chia.net/testnet10/) and move it to the db folder in the mainnet/ directory in the Chia root folder (i.e. \~/.chia/mainnet/db is the database directory). +:::note + _Make sure to unzip the database before continuing to the next step._ +::: + :::tip Prior to starting your node, it is recommended to delete `peers.dat`, located in `~/.chia/mainnet/db`. If you don't delete this file you might see `WARNING Invalid handshake with peer` in your log file. The reason for this is that peers.dat will contain mainnet peers, which are not running on the testnet. If you do see these warnings, there's no requirement to take further action -- they'll eventually stop appearing as your invalid peers are replaced with valid ones. @@ -86,7 +93,7 @@ _These instructions are tailored for Linux. A similar approach could likely be f 在某些情况下，您可能希望在主网上耕种的同时，在其中一个测试网络上也进行耕种，而不会将它们从主网中移除。 This is doable with a bit of extra legwork to set up unique ports for the testnet chia installation. -有几个设置的选项。 You can either ensure you have the CHIA_ROOT set to unique values for each instance you want to run, or else run the installations on separate users. These instructions will show setting a specific CHIA_ROOT. +有几个设置的选项。 有几个设置的选项。 You can either ensure you have the CHIA_ROOT set to unique values for each instance you want to run, or else run the installations on separate users. These instructions will show setting a specific CHIA_ROOT. ### Set Up mainnet installation @@ -97,6 +104,7 @@ For the mainnet installation, we will stick with the default ports and CHIA_ROOT :::note (Optional) Install `yq` to make editing the yaml files easier [https://github.com/mikefarah/yq#install](https://github.com/mikefarah/yq#install).\ +Alternatively, you can manually edit the ports in `config.yaml`.\ Alternatively, you can manually edit the ports in `config.yaml`. ::: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md new file mode 100644 index 0000000000..929f976ca9 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md @@ -0,0 +1,320 @@ +--- +title: Timelords +slug: /timelord-install +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +:::warning +**DO NOT** overclock ASICs, overclocking diminishes the life of the ASIC! +::: + +Timelord architecture information can be found [here](/timelord-architecture).\ +The hw_vdf_client parameter information can be found [here](/asic-cli). + +--- + +## Timelord Requirements and Dependencies + +:::info +Due to restrictions on how [MSVC](https://en.wikipedia.org/wiki/Microsoft_Visual_C%2B%2B) handles 128 bit numbers and how Python relies upon MSVC, it is not possible to build and run Timelords of all types on Windows.\ +Running a timelord on a farming machine will reduce the efficiency of the farmer and the timelord, for this reason it is recommended to have a dedicated machine for running timelords. +::: + +Requirements: + +1. Software Timelord + - With the release of ASIC timelords, software timelords will have a near impossible time competing. It is recommended to only run a software timelord for experimentation and learning purposes. + - Dedicated host machine that is a modern gaming PC with minimum 6 fast cores and 8GB of RAM. +2. Bluebox Timelord + - Dedicated host machine that is a modern gaming PC with minimum 6 fast cores and 8GB of RAM. +3. ASIC Timelord + - The ASIC hardware + - Dedicated host machine that is a modern gaming PC with minimum 6 fast cores and 8GB of RAM. + - Two USB-C cables (one for power and one for data). Preferably USB-C to USB-C but we have successfully tested USB-A to USB-C without too much performance loss. + +Dependencies: + +- linux OS, our testing has been with Ubuntu 22 and newer +- git (if installing from source) +- ca-certificates curl gnupg (if installing from APT or if running an ASIC - RECOMMENDED) + +--- + +## Installing a Timelord + +:::info +Timelords execute sequential verifiable delay functions (proofs of time or VDFs), that get added to blocks to make them valid. This requires fast CPUs and a few cores per VDF. +::: + +\ +:::info +Use `chia-blockchain-cli` instead of `chia-blockchain` for CLI only version that does not have a GUI. +::: + +```bash +# Install packages +sudo apt-get update +sudo apt-get install ca-certificates curl gnupg + +# Add GPG key +curl -sL https://repo.chia.net/FD39E6D3.pubkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/chia.gpg + +# Set up repository +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/debian/ stable main" | sudo tee /etc/apt/sources.list.d/chia.list > /dev/null +sudo apt-get update + +# Install chia-blockchain +sudo apt-get install chia-blockchain + +# Launch timelord +chia start node timelord & +``` + + + + +```bash +# Install packages +sudo apt-get update +sudo apt-get install ca-certificates curl gnupg + +# Add GPG key +curl -sL https://repo.chia.net/FD39E6D3.pubkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/chia.gpg + +# Set up repository +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/debian/ stable main" | sudo tee /etc/apt/sources.list.d/chia.list > /dev/null +sudo apt-get update + +# Install chia-blockchain +sudo apt-get install chia-blockchain + +# Bluebox timelord setup +For bluebox timelords you will need to make two changes to `~/.chia/mainnet/config.yaml`. +- In the `timelord:` section, set `bluebox_mode:` to `True`. +- In the `full_node:` section and set `send_uncompact_interval:` to something greater than 0. We recommend `300` seconds there so that your Bluebox has some time to prove through a lot of the un-compacted Proofs of Time before the node drops more into its lap. + +Note - The default settings may otherwise work but if the total effort is a little too much for whatever machine you are on you can also lower the `process_count:` from 3 to 2, or even 1, in the `timelord_launcher:` section. You know it is working if you see `VDF Client: Sent proof` in your logs at INFO level. + +# Launch timelord +chia start node timelord & +``` + + + + +:::warning +**DO NOT** overclock ASICs, overclocking diminishes the life of the ASIC!\ +Detailed information about the hw_vdf_client parameters can be found [here](/asic-cli). +::: + +#### ASIC Cluster Setup + +It is recommended to use three host machines for ASIC clusters in a setup similar to: + +``` + _____ ASIC 2 (ASIC software only, IP set to main machine) + / +Main Machine (ASIC 1) -------------------------- +(chia node, timelord-only, and ASIC software) \_____ ASIC 3 (ASIC software only, IP set to main machine) +``` + +For an ASIC cluster you will need to follow the below install steps on the main machine to include the chia node, timelord-only, and ASIC software processes are all being run on the main machine.\ +The additional ASIC hosts will only need the ASIC software installed (noted in the below install instructions). + +```bash +# Install packages +sudo apt-get update +sudo apt-get install ca-certificates curl gnupg + +# Add GPG key +curl -sL https://repo.chia.net/FD39E6D3.pubkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/chia.gpg + +# Set up repositories (first is for chia and second is for the hw vdf repo, for clusters the chia software is only needed on the main machine all other hosts need the hw vdf repo) +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/debian/ stable main" | sudo tee /etc/apt/sources.list.d/chia.list > /dev/null +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/chiavdf-hw/debian/ stable main" | sudo tee /etc/apt/sources.list.d/chiavdf-hw.list > /dev/null +sudo apt-get update + +# Install chia-blockchain and ASIC repos (for clusters the chia software is only needed on the main machine all other hosts need the hw vdf repo) +sudo apt-get install chia-blockchain +sudo apt-get install chiavdf-hw + +# Launch the ASIC timelord services (for clusters verify the IP address is correct and launch with only 1 VDF for each) +hw_vdf_client --ip 127.0.0.1 8000 3 + +# Launch timelord services in chia (for clusters only the main machine should be running the node and timelord services) +chia start node timelord-only +``` + + + + +### Installing a Timelord from Source + +:::info +On MacOS x86_64 and all Linux distributions, building a Timelord is as easy as running `chia start timelord &` in the virtual environment. You can also run `./vdf_bench square_asm 400000` once you've built Timelord to give you a sense of your optimal and unloaded ips. Each run of `vdf_bench` can be surprisingly variable and, in production, the actual ips you will obtain will usually be about 20% lower due to load of creating proofs. The default configuration for Timelords is good enough to just let you start it up. Set your log level to INFO and then grep for "Estimated IPS:" to get a sense of what actual ips your Timelord is achieving.\ +Detailed information about the hw_vdf_client parameters can be found [here](/asic-cli). +::: + +```bash +# Download chia-blockchain (for clusters the chia software is only needed on the main machine all other hosts need the hw vdf repo) +git clone https://github.com/Chia-Network/chia-blockchain -b latest --recurse-submodules + +# Change directory +cd chia-blockchain + +# Install dependencies +sh install.sh + +# Activate virtual environment +. ./activate + +# Initialize +chia init +. ./activate + +# Install timelord +sh install-timelord.sh + +# Start timelord (skip this step and proceed below if installing a bluebox or ASIC timelord) +chia start full_node timelord + +# Bluebox timelord setup +Once you build the Timelord with `sh install-timelord.sh` in the virtual environment, you will need to make two changes to `~/.chia/VERSION/config.yaml`. +- In the `timelord:` section, set `bluebox_mode:` to `True`. +- In the `full_node:` section and set `send_uncompact_interval:` to something greater than 0. We recommend `300` seconds there so that your Bluebox has some time to prove through a lot of the un-compacted Proofs of Time before the node drops more into its lap. + +Note - The default settings may otherwise work but if the total effort is a little too much for whatever machine you are on you can also lower the `process_count:` from 3 to 2, or even 1, in the `timelord_launcher:` section. You know it is working if you see `VDF Client: Sent proof` in your logs at INFO level. + +# ASIC timelord setup: install the timelord repo, run the timelord-only chia service, and run the ASIC software +## Install packages +sudo apt-get update +sudo apt-get install ca-certificates curl gnupg + +## Add GPG key +curl -sL https://repo.chia.net/FD39E6D3.pubkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/chia.gpg + +## Set up hw vdf repository (for clusters the chia software is only needed on the main machine all other hosts need the hw vdf repo) +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/chiavdf-hw/debian/ stable main" | sudo tee /etc/apt/sources.list.d/chiavdf-hw.list > /dev/null +sudo apt-get update + +## Install ASIC repo +sudo apt-get install chiavdf-hw + +# Launch the ASIC timelord services (for clusters verify the IP address is correct and launch with only 1 VDF for each) +hw_vdf_client --ip 127.0.0.1 8000 3 + +## Launch the timelord-only chia service (for clusters only the main machine should be running the node and timelord services) +chia start node timelord-only + +``` + +--- + +## ASIC Timelord Systemd Setup + +Below is an example of a systemd service file to run the ASIC hw vdf processes.\ +NOTE - make sure to replace `USERNAME` with your system's username. + +```bash +# Create systemd service +sudo nano /etc/systemd/system/chiahw-vdf.service + +# Copy the data from below replacing USERNAME with your system's username +``` + +### Example ASIC systemd File + +```bash +[Unit] +Description=Chia HW VDF Service + +[Service] +Type=simple +ExecStart=/usr/bin/hw_vdf_client --ip 127.0.0.1 8000 3 +User=USERNAME +Group=USERNAME +LimitNOFILE=1048576 +LimitNPROC=1048576 +LimitCORE=infinity + +[Install] +WantedBy=multi-user.target +``` + +```bash +# Save and start the systemd service +CTRL+O # save the file +CTRL-X # exit the nano editor + +# Reload and start the systemd services +sudo systemctl daemon-reload +sudo systemctl enable chiahw-vdf.service +sudo systemctl start chiahw-vdf.service +sudo systemctl status chiahw-vdf.service +``` + +### Using the systemd Service + +Restart the ASIC systemd software: +`sudo systemctl restart chiahw-vdf.service` + +Stop the ASIC systemd software: +`sudo systemctl stop chiahw-vdf.service` + +Check status of the ASIC systemd software: +`sudo systemctl status chiahw-vdf.service` + +--- + +## Troubleshooting a Timelord + +For troubleshooting steps please refer to the documentation [here](/troubleshooting/timelords). + +--- + +## Timelord support + +Join Our [Discord](https://discord.gg/chia) and jump into the #support channel for support + +--- + +## Timelord FAQ + +### What are the hardware requirements for running a Timelord? + +There are no specific requirements as timelords are a fastest wins process. This means that those with higher end hardware are more likely to generate Proofs of Time than those with lower end hardware. +Currently, a modern gaming PC with 8 cores and 8 GB of RAM is recommended when running an ASIC or Bluebox timelord. With the release of ASIC timelords, software timelords will have a near impossible time competing. It is recommended to only run a software timelord for experimentation and learning purposes. + +### Can a Single ASIC Compete with an ASIC Cluster? + +The nature of timelords is to create three VDF chains, one can create the chains themselves in parallel (i.e. one on each ASIC) but one cannot break down the VDFs themselves to parallelize them. +This means that the ASIC cluster will always have an advantage but there are times when a single ASIC can reasonably compete. This almost always requires the block farming node to be closer in physical proximity to the single ASIC than to the ASIC cluster establishing a minor time advantage for the single ASIC + +### Can I Overclock the ASIC to Get More Performance or Higher IPS? + +While one can overclock the ASIC we very strongly recommend against doing such. Overclocking the ASICs will lead to diminishing longevity of the machine and only provides a minor increase in performance making it inefficient to overclock an ASIC. + +### What Voltage Should I Use for an ASIC Timelord? + +It is highly recommend to use the default `0.88` voltage. + +### What OS is Compatible with Running a Timelord? + +It is recommended to use a linux OS to run timelords as these are the most performant. +If running on a MAC, one can compile the chia repo from source and run the timelord services but this is currently only compatible with Intel chips and not compatible with the silicon chip. +Windows is not recommended, due to restrictions on how [MSVC](https://en.wikipedia.org/wiki/Microsoft_Visual_C%2B%2B) handles 128 bit numbers and how Python relies upon MSVC, it is not possible to build and run Timelords of all types on Windows. + +### What System Resources are most Important for an ASIC? + +The single thread speed is one of the most important factors for having a faster ASIC. + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/using-the-gui.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/using-the-gui.md index b5d2d007a2..b46bf62e0d 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/using-the-gui.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/using-the-gui.md @@ -31,7 +31,7 @@ Enabling a passphrase is a recommended step for protecting your funds, but it on ## Syncing -Upon opening Chia, your wallet will need to sync. You'll need to see a green checkmark next to the **WALLET** label in the upper-right corner before seeing any tokens you have. +Upon opening Chia, your wallet will need to sync. Upon opening Chia, your wallet will need to sync. You'll need to see a green checkmark next to the **WALLET** label in the upper-right corner before seeing any tokens you have.

synced @@ -96,3 +96,11 @@ When acquiring NFTs or tokens, you may need to make an offer for them. Offers ar By using offers you are embracing the decentralized nature of the Chia blockchain. [Read more about offers](https://chialisp.com/offers). + +## Run Chia Services in the Background + +Starting in version 2.3.0, this is possible. When you attempt to close the application, the confirmation window will now display a checkbox. If you want to continue running your full node, harvester, farmer, etc after closing the GUI, be sure to check the checkbox, as demonstrated in the following image: + +

+ offers +

diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md index fcf1847d8f..8aa6e48fca 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md @@ -51,13 +51,13 @@ Assuming you don't have a wallet yet, click `CREATE A NEW WALLET KEY` (If you al

-You will be presented with a list of twenty-four words. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is also important. +You will be presented with a list of twenty-four words. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is important. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is also important. -You can also choose a custom name for your wallet. Click `NEXT` when you are finished. +You can also choose a custom name for your wallet. Click NEXT when you are finished. Click `NEXT` when you are finished. :::warning -If someone obtains a copy of these words, they can steal your entire wallet, including all of its funds. Be sure to store your recovery phrase in a safe place. +If someone obtains a copy of these words, they can steal your entire wallet, including all of its funds. Be sure to store your recovery phrase in a safe place. Be sure to store your recovery phrase in a safe place. ::: @@ -91,7 +91,7 @@ Chia Asset Tokens (CATs) are fungible assets on Chia's blockchain. In Chia parla
manage token list -
+

2. The Chia reference wallet comes with a few included CATs, but most will need to be entered manually. If you want to add one of the included CATs, click the slider next to the CAT you would like to add. @@ -99,14 +99,14 @@ Chia Asset Tokens (CATs) are fungible assets on Chia's blockchain. In Chia parla
add token -
+

3. If your new CAT is not included in the reference wallet, you will need to obtain its Asset ID (TAIL). There are multiple websites that provide a listing of CATs and their IDs. One such site is [spacescan.io](https://www.spacescan.io). Simply browse to the website, then search for your CAT. For example, here is a search for "dexie bucks":
search for dexie bucks -
+

In addition to CATs, Spacescan provides a listing of NFTs. In certain cases, such as with Dexie Bucks, there are CAT _and_ NFT collections with the same name. In this case, be sure to click on `CAT2`, as in the above image. @@ -115,21 +115,21 @@ The result will show you the details of the CAT you selected, including its ID.
copy dexie bucks ID -
+

It is recommended that you check with another source of truth to make sure you have the correct ID. Another website that provides a listing of CATs and their IDs is [taildatabase.com](https://www.taildatabase.com/). Browse to this site, click the `Explore` menu, and search for your CAT. The name should appear in the search results:
taildatabase dexie bucks search -
+

Some information about the CAT will appear, including its Asset ID, as highlighted here:
taildatabase dexie bucks asset ID -
+

Copy this ID and continue to the next step. @@ -144,7 +144,7 @@ If someone sends you an Asset ID (TAIL), do not assume it is correct. Instead, d
One Meeellion CATs -
+

Your new CAT will now appear in the "Tokens" list in your wallet. @@ -157,7 +157,7 @@ For our first example Offer, we will offer 1 XCH in exchange for the new CAT.
create an offer -
+

2. Next, fill in the details of the Offer. By default, the Offer will be set to expire after 7 days. This is likely fine in most cases. (If an Offer never expires, there is a chance it will be taken as arbitrage long after the maker has forgotten about it.) However, feel free to enter a different expiration time if desired. @@ -168,14 +168,14 @@ After all of the details have been filled in, click `CREATE OFFER`:
fill in offer details -
+

3. If anyone acquires this Offer and it is still valid, they will be able to take it. Click the `I UNDERSTAND` button and the Offer will be created:
confirm offer -
+

3. At this point, the Offer has been created locally. However, until you share it, it is unlikely that anyone will know it exists. Feel free to email the Offer file, share it on social media, etc. The Offer file does not contain any sensitive data. Whoever sees it will only have two options: take it or ignore it. @@ -188,14 +188,14 @@ _ Spacescan -- an explorer and bulletin board \* Finally, you can save the file
distribute offer -
+

4. The Offer will now appear as `Pending Accept`, and the amount of time (if any) until it expires will also be shown:
offer pending status -
+

Congratulations! You have created an Offer. A few things to note: @@ -215,73 +215,73 @@ This example will use a different computer to accept the Offer that was created
One Meeellion CATs -
+

2. Click `Offers`, then view the Offer by either loading, dragging/dropping, or pasting the file:
view offer -
+

3. In this case, the Offer will expire in 6 days. The Taker must give 1000 CATs in exchange for 1 TXCH. The Maker has included a blockchain fee, and the Taker has the option of adding to this fee if desired. If the terms are acceptable, click `ACCEPT OFFER`:
accept offer -
+

4. You will need to confirm that you actually want to accept the Offer, which will initiate an on-chain transaction:
verify acceptance of offer -
+

5. The Offer has been accepted. Click `OK`:
offer accepted -
+

6. While the blockchain transaction is pending, you will see this status in the `Offers you accepted` panel:
offer pending confirm -
+

7. Meanwhile, the `Tokens` screen will show the pending XCH and CAT amounts:
1 XCH incoming -
+

1000 CATs outgoing -
+

8. After the transaction has been confirmed (typically 1-3 minutes), the Offer's status will be updated to `Confirmed`:
plus 1 XCH -
+

9. The final XCH and CAT balances will then be reflected in the `Tokens` screen:
minus 1000 CATs -
+

offer pending status -
+

--- @@ -296,17 +296,17 @@ Click the three dots in the "Actions" column:
Pending Accept -
+

-2. Click "Cancel Offer". +2. Click "Cancel Offer".
Cancel Offer -
+

-3. The "Cancel Offer" dialog will appear. The default option is to cancel on the blockchain, as shown in the red circle in the image below. +3. The "Cancel Offer" dialog will appear. The default option is to cancel on the blockchain, as shown in the red circle in the image below. This option will use your wallet to spend the coin(s) you had offered, and create new coins of the same type and value. This process does not involve taking the other end of the Offer, so you will not receive any funds of the type you had requested. The end result is that your wallet's balance will be the same as it was before you made the Offer (minus any transaction fees). @@ -314,30 +314,30 @@ The advantage of canceling in this manner is that it ensures that nobody can acc
Cancel on blockchain -
+

-4. If you uncheck the checkbox, your wallet will un-reserve the coins for your Offer. However, nothing will be recorded on the blockchain. If you have copied your Offer file elsewhere, someone could still accept it. +4. If you uncheck the checkbox, your wallet will un-reserve the coins for your Offer. However, nothing will be recorded on the blockchain. If you have copied your Offer file elsewhere, someone could still accept it. The advantages of this option are that it will cancel your Offer instantly, and there's no need to include a fee.
Cancel off chain -
+

-5. If you left the checkbox checked in the previous step, your Offer will enter the "Pending Cancel" state while the cancellation is being recorded on the blockchain. This could take several minutes. +5. If you left the checkbox checked in the previous step, your Offer will enter the "Pending Cancel" state while the cancellation is being recorded on the blockchain. This could take several minutes.
Pending Cancel -
+

-6. When your order has been successfully canceled, it will enter the "Cancelled" state. Your funds are now available in your wallet. +6. When your order has been successfully canceled, it will enter the "Cancelled" state. Your funds are now available in your wallet.
Cancelled -
+

--- @@ -350,28 +350,28 @@ You can also create Offers to buy or sell NFTs. While it is possible to select N
Cancelled -
+

2. In this case, both of the NFTs are selected. Next, click `ACTIONS` and `Create Offer`:
Cancelled -
+

3. The `Offer Maker` dialog will appear. Fill in any additional details for your Offer (be sure to request something!), and click `CREATE OFFER`:
Cancelled -
+

3. Share the Offer as you would with a CAT Offer. After the Offer has been created, the NFTs being offered will appear in the Offer summary:
Cancelled -
+

--- @@ -384,21 +384,21 @@ You can also swap NFTs for other NFTs, just like trading cards.
Multi NFT swap -
+

2. When you are satisfied with terms of the Offer, click `CREATE OFFER`:
Cancelled -
+

3. After the Offer has been created, the assets to be trade will be displayed in the summary, just as with other Offers:
Cancelled -
+

--- @@ -413,42 +413,42 @@ This example will continue with the same NFT-NFT Offer from the last section.
Share on Dexie -
+

2. Be sure to verify that the Offer is correct; after it is shared publicly, someone could accept it:
Share Offer -
+

3. Click `NOTIFY CURRENT OWNER`:
Notify current owner -
+

4. You have the option to add a transaction fee for the notification. You can also choose whether to allow counter offers:
Send message -
+

5. A new offer coin will be created. If the owner of the NFT you would like to acquire is using the reference wallet, the wallet will notice this new coin and examine its contents. A new notification will appear in the owner's wallet. Click the notification bell:
Incoming notification -
+

6. A summary of the Offer will appear. Click the summary to see the details of the Offer:
View Offer -
+

--- @@ -497,6 +497,7 @@ Let's say a Maker has wallets for XCH and CKC, with no money in either of them.
0 CKC wallet
+
The maker attempts to make an ambitious offer: 100 XCH for 1 million CKC. @@ -570,6 +571,7 @@ There is a warning dialog about the unknown cat, after which the Offer is confir
Unknown CAT success
+
Notice that the Offer file was named `0.25_Shibe_for_0.1_XCH.offer`, but the file name itself does _not_ dictate the contents of the Offer. The Taker may have inadvertently accepted an Offer for a worthless token! @@ -604,6 +606,7 @@ Let's say a Maker has 0.1 XCH and 1 USDS:
1 USDS in wallet
+
The Maker offers 0.1 XCH in exchange for 10 USDS: @@ -635,6 +638,7 @@ After the Offer has been canceled, a Taker notices the Offer file and decides to
Confirm a canceled offer
+
Later, the Maker notices that the Offer has gone through, despite having been canceled: @@ -645,6 +649,7 @@ Later, the Maker notices that the Offer has gone through, despite having been ca
Post-offer 11 USDS
+
If the Offer had been canceled on-chain, the reserved coins would have been spent. At that point, even if someone else had gotten access to the Offer file, the Offer itself would've been invalid. @@ -667,6 +672,7 @@ For example, let's say a Maker has 1 XCH and 0 USDS:
0 USDS in wallet
+
The Maker creates an Offer of 0.1 XCH for 10 USDS. @@ -683,10 +689,13 @@ This is viewable in the offer's details:
One coin used for offer +
Scroll to the bottom to view coins reserved for the Offer.
+ +
While the Offer is pending, the Maker attempts to send 0.1 XCH to another address. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md index 181b63c4e5..16210e7f7e 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md @@ -8,29 +8,29 @@ slug: /constants-variables-notation ## 0.1 重要常数 -| 常数 | Description | -| ----------- | ----------------------------------------- | -| 10分钟 | 目标 **子时隙（sub-slot）的间隔时长** | -| 32个区块 | 每个目标 **子时隙的区块数量** | -| 16/64个区块 | 每个时隙的最小/最大区块数量 | -| 4608个区块 | 平均每个**纪元（epoch）的区块**数量 | +| 常数 | Description | +| -------- | --------------------------- | +| 10分钟 | 目标 **子时隙（sub-slot）的间隔时长** | +| 32个区块 | 每个目标 **子时隙的区块数量** | +| 16/64个区块 | 每个时隙的最小/最大区块数量 | +| 4608个区块 | 平均每个**纪元（epoch）的区块**数量 | | 384个区块 | 平均每个**子纪元（sub-epoch）的区块**数量 | -| 64个签名点 | 每个**子时隙的签名点**数量 | +| 64个签名点 | 每个**子时隙的签名点**数量 | 由上可得以下结论： -| 隐含的常数 | Description | -| ---------- | ------------------------------------------------------------------------------------------------------------------------- | -| 1天 | **一个纪元的时长**为 $$10 {\ \sf min}\cdot\frac{4608{\ \sf blocks}}{32\ \sf blocks}=1440{\ \sf min}\quad (=1{ \sf day})$$ | -| 2小时 | **目标**子纪元的时长\*\*\*\* | -| 18.75秒 | 平均**完成一个区块的时长**为 $\frac{10{\sf\ min}}{32}=18.75 {\sf\ sec}$ | -| 9.375秒 | **签名点之间的时长**为 $\frac{600}{64}=9.375 {\sf\ sec}$ | +| 隐含的常数 | Description | +| ------ | ----------------------------------------------------------------------------------------------------------------------------- | +| 1天 | **一个纪元的时长**为 $$10 {\ \sf min}\cdot\frac{4608{\ \sf blocks}}{32\ \sf blocks}=1440{\ \sf min}\quad (=1{ \sf day})$$ | +| 2小时 | **目标**子纪元的时长**** | +| 18.75秒 | 平均**完成一个区块的时长**为 $\frac{10{\sf\ min}}{32}=18.75 {\sf\ sec}$ | +| 9.375秒 | **签名点之间的时长**为 $\frac{600}{64}=9.375 {\sf\ sec}$ | ## 0.2 重要变量 -| 变量 | Description | -| ------------------ | -------------------------------------------------------------------------------- | -| $D\in{\mathbb N}$ | 难度参数。 每个纪元重新校准一次，以满足每个时隙（slot）32个区块的目标 | +| 变量 | Description | +| -------------------- | ------------------------------------------- | +| $D\in{\mathbb N}$ | 难度参数。 每个纪元重新校准一次，以满足每个时隙（slot）32个区块的目标 | | $T\in {\mathbb N}$ | 时间参数（子时隙的VDF步数）。 每个纪元重新校准一次，以满足每个子时隙10分钟的目标 | ## 0.3 提示 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-abstract.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-abstract.md index dacb226e69..81e963a3a5 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-abstract.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-abstract.md @@ -18,4 +18,4 @@ slug: /green-paper-abstract ### 先前版本共识绿皮书 -为了提供历史背景，绿皮书的先前版本讨论了一种从未实现的共识，可以在这里查看：[先前绿皮书](/files/Precursor-ChiaGreenPaper.pdf)。 +In order to provide historical context, the Green Paper's previous version that discusses a precursor consensus which was never implemented is available here for viewing: [Precursor Green Paper](https://docs.chia.net/assets/files/Precursor-ChiaGreenPaper-82cb50060c575f3f71444a4b7430fb9d.pdf). diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md index 19ecff6b0a..d50a92e9e5 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md @@ -12,21 +12,13 @@ In this section we sketch the main building blocks used in the $\textsf{Chia}$  A digital signature scheme is specified by three algorithms; a (probabilistic) key-generation algorithm ${{\sf Sig.keygen}}$, a signing algorithm $\mu\gets {{\sf Sig.sign}}(sk,m)$ and a verification algorithm ${{\sf Sig.verify}}$. We assume the standard security notion (unforgeability under chosen message attacks) and perfect completeness, that is, a correctly generated signature will always verify: -$$ -\begin{aligned} -\forall m,&& -\Pr[{{\sf Sig.verify}}(pk,m,\mu)={\sf accept}]=1\\ -\textrm{where}&&(pk,sk)\gets{{\sf Sig.keygen}}\ ;\ \mu\gets{{\sf Sig.sign}}(sk,m)~. -\end{aligned} -$$ +$$ \begin{aligned} \forall m,&& \Pr[{{\sf Sig.verify}}(pk,m,\mu)={\sf accept}]=1\\ +\textrm{where}&&(pk,sk)\gets{{\sf Sig.keygen}}\ ;\ \mu\gets{{\sf Sig.sign}}(sk,m)~. \end{aligned} $$ $\textsf{Chia}$ uses signatures in the foliage (to chain foliage blocks and to bind them to the trunk) and also in the trunk (so only the farmer can compute the challenge). To avoid grinding attacks, the signatures used in the trunk must be unique, that is for every $pk$ (this includes maliciously generated public keys) and message $m$ there can be at most one accepting signature -$$ -\forall pk,m,\ -({{\sf Sig.verify}}(pk,m,\mu)={\sf accept})\wedge -({{\sf Sig.verify}}(pk,m,\mu')={\sf accept})\Rightarrow (\mu=\mu')~. -$$ +$$ \forall pk,m,\ +({{\sf Sig.verify}}(pk,m,\mu)={\sf accept})\wedge ({{\sf Sig.verify}}(pk,m,\mu')={\sf accept})\Rightarrow (\mu=\mu')~. $$ $$ ## A.2 (Unique) Proofs Of Space @@ -56,19 +48,18 @@ To prevent grinding attacks, we need our PoSpace to be unique as defined below. A PoSpace is unique if for any identity $pk$ and any challenge $c$ there is exactly one proof, i.e., -$$ -\begin{aligned} &\forall N,pk,c,\\ &\left|\{\sigma\ :\ \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\right)\wedge \left( (\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right)\}\right|= 1 \end{aligned} -$$ +$$ \begin{aligned} &\forall N,pk,c,\\ +&\left|\{\sigma\ :\ \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\right)\wedge \left( (\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right)\}\right|= 1 \end{aligned} $$ We call a PoSpace _weakly_ unique if the _expected_ number of proofs is close to $1$, i.e., -$$ -\begin{aligned} &\forall N,pk,c,\\ &{\mathrm E}_{c\gets \{0,1\}^w}\left[|\{\sigma : \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\} \right) \wedge \left((\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right) |\right]\\ &\approx 1 \end{aligned} -$$ +$$ \begin{aligned} &\forall N,pk,c,\\ +&{\mathrm E}_{c\gets \{0,1\}^w}\left[|\{\sigma : \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\} \right) \wedge \left((\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right) |\right]\\ +&\approx 1 \end{aligned} $$ For weakly unique PoSpace we assume that whenever there is more than one proof for a given challenge which passes verification, ${\sf PoSpace.prove}(S,c)$ outputs all of them. -The [AAC+17] PoSpace used in $\textsf{Chia}$ is only _weakly unique_. To be able to focus on the main challenges, we will nonetheless assume a _unique_ PoSpace when analyzing $\textsf{Chia}$ but our analysis can be extended without major difficulties to handle weakly unique PoSpace, things just get a bit more messy. +The [AAC+17] PoSpace used in $\textsf{Chia}$ is only _weakly unique_. To be able to focus on the main challenges, we will nonetheless assume a _unique_ PoSpace when analyzing $\textsf{Chia}$ but our analysis can be extended without major difficulties to handle weakly unique PoSpace, things just get a bit more messy. To be able to focus on the main challenges, we will nonetheless assume a _unique_ PoSpace when analyzing $\textsf{Chia}$ but our analysis can be extended without major difficulties to handle weakly unique PoSpace, things just get a bit more messy. ### A.2.4 The [AAC+17] PoSpace @@ -76,15 +67,11 @@ We give a very high level outline of the PoSpace from [Pie19b; Wes20] VDFs discussed below also $\tau.\pi$ is unique. **sequentiality:** Informally, sequentiality states that for any $t$, an adversary ${\cal A}$ who makes less than $t$ sequential steps will not find an accepting proof on a random challenge. I.e., for some tiny $\epsilon$ -$$ -\hspace{-1cm} - \Pr[{\sf VDF.verify}(\tau)={\sf accept}\ \wedge \ \tau.c=c\ \wedge\ \tau.t=t \ :\ c\stackrel{rand}{\gets}\{0,1\}^w,\tau\gets{\cal A}(c,t)]\le \epsilon -$$ +$$ \hspace{-1cm} \Pr[{\sf VDF.verify}(\tau)={\sf accept}\ \wedge \ \tau.c=c\ \wedge\ \tau.t=t \ :\ c\stackrel{rand}{\gets}\{0,1\}^w,\tau\gets{\cal A}(c,t)]\le \epsilon $$ Let us stress that ${\cal A}$ is only bounded by the number of _sequential_ steps, but they can use high parallelism. Thus the VDF output cannot be computed faster by adding parallelism beyond what can be used to speed up a single step of the VDF computation. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md index a0661ab3d5..19af568982 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md @@ -13,7 +13,7 @@ The **$\textsf{Chia}$ network** ([chia.net](https://chia.net/)) is a permission
Figure 1: Illustration of one slot (taking around 10 minutes) of the Chia blockchain. For illustration the slot has just 16 (instead 64) signage points and only 4 blocks (the actual chain has a target of 32).
-As mentioned, $\textsf{Chia}$ is basically what's called a _longest-chain_ protocol in the literature [BNPW19; BDK+19]. This notion captures blockchain protocols that borrow the main ideas from the Bitcoin blockchain: the parties (called miners in Bitcoin and farmers in Chia) that dedicate resources (hashing power in Bitcoin, disk space in Chia) towards securing the blockchain just need to +As mentioned, $\textsf{Chia}$ is basically what's called a _longest-chain_ protocol in the literature [BNPW19; BDK+19]. This notion captures blockchain protocols that borrow the main ideas from the Bitcoin blockchain: the parties (called miners in Bitcoin and farmers in Chia) that dedicate resources (hashing power in Bitcoin, disk space in Chia) towards securing the blockchain just need to This notion captures blockchain protocols that borrow the main ideas from the Bitcoin blockchain: the parties (called miners in Bitcoin and farmers in Chia) that dedicate resources (hashing power in Bitcoin, disk space in Chia) towards securing the blockchain just need to 1. listen to the (P2P) network to learn about progress of the chain and to collect transactions. @@ -23,7 +23,7 @@ As mentioned, $\textsf{Chia}$ is basically what's called a _longest-chain_ prot No other coordination or communication amongst the parties is required. In particular, as the miners in Bitcoin, the farmers in $\textsf{Chia}$ only need to speak up once they find a block and want it to be included in the chain. -Constructing a secure permissionless blockchain using proofs of space is much more challenging than using proofs of work. In particular, a secure (under dynamic availability) longest-chain protocol based on proofs of space alone does not exist [BP22], so Chia's _proofs of space and time_ (PoST) consensus protocol, apart from farmers providing disk space, additionally relies on so called timelords who evaluate verifiable delay functions (VDFs). Figure 2 gives an overview of the formal security proofs and more informal arguments outlined in this document. +Constructing a secure permissionless blockchain using proofs of space is much more challenging than using proofs of work. Constructing a secure permissionless blockchain using proofs of space is much more challenging than using proofs of work. In particular, a secure (under dynamic availability) longest-chain protocol based on proofs of space alone does not exist [BP22], so Chia's _proofs of space and time_ (PoST) consensus protocol, apart from farmers providing disk space, additionally relies on so called timelords who evaluate verifiable delay functions (VDFs). Figure 2 gives an overview of the formal security proofs and more informal arguments outlined in this document. Figure 2 gives an overview of the formal security proofs and more informal arguments outlined in this document.
Diagram of Chia security and arguments @@ -34,17 +34,13 @@ Constructing a secure permissionless blockchain using proofs of space is much mo The Bitcoin blockchain is secure [GKL15] as long as the hashing power $hash_h$ (measured in hashes per second) contributed by honest parties is larger than the hashing power $hash_a$ available to an adversary, i.e., -$$ -hash_h > hash_a -$$ +$$ hash_h > hash_a $$
eq.(1)
Similarly, the security of $\textsf{Chia}$ depends on the amount of space $space_h$ and $space_a$ controlled by the honest parties and the adversary, respectively. Additionally, the speed $vdf_h$ and $vdf_a$ (measured in steps per second) of the VDFs run by the fastest honest timelord and the adversary are relevant. With these definitions, -$$ -\textrm{{\sf Chia}\ is provably secure if : } space_h\cdot vdf_h > space_a \cdot vdf_a \cdot 1.47 -$$ +$$ \textrm{{\sf Chia}\ is provably secure if : } space_h\cdot vdf_h > space_a \cdot vdf_a \cdot 1.47 $$
eq.(2)
@@ -56,9 +52,7 @@ This assumption comes at a prize: there's a $1.47$ factor by which the adversari The bound in eq.(1) is not tight in the sense that we don't have an attack that works if we replace "$>$" with "$<$". We have an attack assuming giving the adversary a slightly lower boosting factor of $1.34$ -$$ -\textrm{double spending in {\sf Chia}\ possible if : }space_h\cdot vdf_h < space_a \cdot vdf_a \cdot 1.34 -$$ +$$ \textrm{double spending in {\sf Chia}\ possible if : }space_h\cdot vdf_h < space_a \cdot vdf_a \cdot 1.34 $$
eq.(3)
@@ -70,9 +64,7 @@ A contribution of this writeup is a modular approach towards achieving secure lo In Bitcoin each block contains the hash of the previous block. If two blocks are found at roughly the same time, so there was no time for the block that was found first to propagate to the miner that found the second, they will refer to the same block, and only one can be added to the chain. The other will be "orphaned" and does not contribute towards securing the blockchain. The fraction of orphaned blocks depends on the network delay (the smaller the delay the fewer orphans) and the block-arrival time (fewer blocks per minute decrease the probability of orphans). Taking this into account, the security statement for Bitcoin from eq.(1) should be augmented to: -$$ -hash_h \cdot \left(1-\frac{network\ delay}{block\ arrival\ time}\right)> hash_a -$$ +$$ hash_h \cdot \left(1-\frac{network\ delay}{block\ arrival\ time}\right)> hash_a $$
eq.(4)
@@ -176,7 +168,7 @@ A block $\beta=\{\beta_F,\beta_T\}$ is made of two parts, the foliage block $\be - A timelord computes the ${\cal RC},{\cal CC},{\sf i}{\cal CC},{\cal FC}$ chains and broadcasts relevant values to the network. This includes signage points ${\sf rc\_sp}$ and ${\sf cc\_sp}$ which are the values of the ${\cal RC}$ and ${\cal CC}$ chains (together with a proof that these values are on the VDF chains) once every $9.375$ seconds. -- A farmer who receives these _signage points_ ${\sf rc\_sp}$ and ${\sf cc\_sp}$ checks whether these points are of interest (i.e., on the heaviest known chain) and all the VDF proofs verify. Next, for each of their plots, they use ${\sf cc\_sp}$ as a challenge to compute a PoSpace $\sigma$. Then they check whether $\sigma$ satisfies a winning condition that allows to produce a block. +- A farmer who receives these _signage points_ ${\sf rc\_sp}$ and ${\sf cc\_sp}$ checks whether these points are of interest (i.e., on the heaviest known chain) and all the VDF proofs verify. Next, for each of their plots, they use ${\sf cc\_sp}$ as a challenge to compute a PoSpace $\sigma$. Then they check whether $\sigma$ satisfies a winning condition that allows to produce a block. Next, for each of their plots, they use ${\sf cc\_sp}$ as a challenge to compute a PoSpace $\sigma$. Then they check whether $\sigma$ satisfies a winning condition that allows to produce a block. If a winning PoSpace $\sigma$ is found, the farmer creates a signature $\mu_{\sf rc\_sp}$ of ${\sf rc\_sp}$ (that verifies under the $pk$ associated with $\sigma$) and a foliage block $\beta_F$ and then gossips the block $\beta=\{\beta_F,\beta_T=\{\sigma,\mu_{\sf rc\_sp}\}\}$. @@ -188,7 +180,7 @@ A block $\beta=\{\beta_F,\beta_T\}$ is made of two parts, the foliage block $\be (${\sf i}{\cal CC}$) For some extra security, the timelord doesn't simply wait till the end of the slot to infuse the signature, but a third VDF is used to fork from ${\cal CC}$ at the infusion point by infusing $\mu_{\sf rc\_sp}$ into ${\cal CC}$, and this fork, called the infused challenge chain ${\sf i}{\cal CC}$, is then infused back to ${\cal CC}$ at the end of the slot. - (${\cal FC}$) Iff the signage point of this block is later than the infusion point of the last _transaction block_, then this block is also a transaction block. Only in this case its foliage $\beta_F$ is appended to the foliage (hash) chain ${\cal FC}$, and this block becomes a "transaction block". + (${\cal FC}$) Iff the signage point of this block is later than the infusion point of the last _transaction block_, then this block is also a transaction block. Only in this case its foliage $\beta_F$ is appended to the foliage (hash) chain ${\cal FC}$, and this block becomes a "transaction block". Only in this case its foliage $\beta_F$ is appended to the foliage (hash) chain ${\cal FC}$, and this block becomes a "transaction block". ## 1.8 Space Oddities @@ -196,7 +188,7 @@ When constructing a proof of stake or proof or a space based longest-chain proto ### 1.8.1 Sized vs. Unsized -A key difference between stake and work is the fact that in a stake based chain we know the amount of the resource available for mining, while for an external resource like work or space this is no longer the case. Lewis-Pye and Roughgarden [Lew21; LR21] formalize this as the _sized_ vs. _unsized_ setting and prove some fundamental differences between them. The main result in [LR21] shows that _certificates_ which "provide incontrovertible proof of block confirmation", only exist in the sized setting, i.e., for PoStake but not PoWork blockchains. +A key difference between stake and work is the fact that in a stake based chain we know the amount of the resource available for mining, while for an external resource like work or space this is no longer the case. Lewis-Pye and Roughgarden [Lew21; LR21] formalize this as the _sized_ vs. _unsized_ setting and prove some fundamental differences between them. A key difference between stake and work is the fact that in a stake based chain we know the amount of the resource available for mining, while for an external resource like work or space this is no longer the case. Lewis-Pye and Roughgarden [Lew21; LR21] formalize this as the _sized_ vs. _unsized_ setting and prove some fundamental differences between them. The main result in [LR21] shows that _certificates_ which "provide incontrovertible proof of block confirmation", only exist in the sized setting, i.e., for PoStake but not PoWork blockchains. In their framework _space_ and also _space and time_ (i.e., the available space multiplied with the speed of the available VDFs) as used in $\textsf{Chia}$ are an unsized resource, so we can't hope to get certificates. @@ -210,7 +202,7 @@ To prevent such attacks some chain require parties to delete old keys, but it's ### 1.8.3 Replotting -A subtle but important difference between stake and space is the fact that space allows for _replotting_ which has no analogue in the stake setting: Given a challenge $c$, a space farmer controlling a plot $S$ of size $N$ can _efficiently_ compute _one_ proof $\sigma \gets {\sf PoSpace.prove}(S,c)$. This is analogous to the stake based setting, but unlike in the stake setting, the farmer can _inefficiently_ compute _multiple_ proofs for challenge $c$ by repeatedly creating fresh plots and computing one proof with each of them. +A subtle but important difference between stake and space is the fact that space allows for _replotting_ which has no analogue in the stake setting: Given a challenge $c$, a space farmer controlling a plot $S$ of size $N$ can _efficiently_ compute _one_ proof $\sigma \gets {\sf PoSpace.prove}(S,c)$. This is analogous to the stake based setting, but unlike in the stake setting, the farmer can _inefficiently_ compute _multiple_ proofs for challenge $c$ by repeatedly creating fresh plots and computing one proof with each of them. This is analogous to the stake based setting, but unlike in the stake setting, the farmer can _inefficiently_ compute _multiple_ proofs for challenge $c$ by repeatedly creating fresh plots and computing one proof with each of them. We refer to attacks exploiting this fact as _replotting attacks_. The most basic design choice to harden a chain against replotting attacks is to make sure that challenges arrive at a sufficiently high rate so that substantial replotting in-between two challenges is not feasible. Moreover the plot filter (which dictates what fraction of plots must be accessed with every challenge) cannot be chosen too aggressively as more aggressive filters makes potential replotting attacks easier. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md index 3a6cf430d8..8ba22edd52 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md @@ -6,35 +6,35 @@ slug: /green-paper-references # References -| Identifier | Publication | -| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| AAC+17 | Hamza Abusalah, Joël Alwen, Bram Cohen, Danylo Khilko, Krzysztof Pietrzak, and Leonid Reyzin. Beyond Hellman’s time-memory trade-offs with applications to proofs of space. In Tsuyoshi Takagi and Thomas Peyrin, editors, _Advances in Cryptology - ASI- ACRYPT 2017 - 23rd International Conference on the Theory and Applications of Cryptology and Information Security, Hong Kong, China, December 3-7, 2017, Proceedings, Part II_, volume 10625 of _Lecture Notes in Computer Science_, pages 357–379. Springer, 2017. | -| BBBF18 | Dan Boneh, Joseph Bonneau, Benedikt Bu ̈nz, and Ben Fisch. Verifiable delay functions. In Hovav Shacham and Alexandra Boldyreva, editors, _Advances in Cryptology - CRYPTO 2018 - 38th Annual International Cryptology Conference, Santa Barbara, CA, USA, August 19-23, 2018, Proceedings, Part I, volume 10991 of Lecture Notes in Computer Science_, pages 757–788. Springer, 2018. | -| BBF18 | Dan Boneh, Benedikt Bu ̈nz, and Ben Fisch. A survey of two verifi- able delay functions. _IACR Cryptol. ePrint Arch._, page 712, 2018. | -| BDK+19 | Vivek Bagaria, Amir Dembo, Sreeram Kannan, Sewoong Oh, David Tse, Pramod Viswanath, Xuechao Wang, and Ofer Zeitouni. Proof- of-stake longest chain protocols: Security vs predictability. 2019. | -| BGK+18 | Christian Badertscher, Peter Gazi, Aggelos Kiayias, Alexander Russell, and Vassilis Zikas. Ouroboros genesis: Composable proof-of-stake blockchains with dynamic availability. In David Lie, Mohammad Mannan, Michael Backes, and XiaoFeng Wang, editors, _Proceedings of the 2018 ACM SIGSAC Conference on Computer and Communications Security, CCS 2018, Toronto, ON, Canada, October 15-19, 2018_, pages 913–930. ACM, 2018. | -| BNPW19 | Jonah Brown-Cohen, Arvind Narayanan, Alexandros Psomas, and S. Matthew Weinberg. Formal barriers to longest-chain proof-of-stake protocols. In Anna Karlin, Nicole Immorlica, and Ramesh Johari, editors, _Proceedings of the 2019 ACM Conference on Economics and Computation, EC 2019, Phoenix, AZ, USA, June 24-28, 2019_, pages 459–473. ACM, 2019. | -| BP22 | Mirza Ahad Baig and Krzysztof Pietrzak. On the existence of proof of space longest chain protocols (working title), 2022. 2022. Manuscript in preparation. | -| CKWN16 | Miles Carlsten, Harry A. Kalodner, S. Matthew Weinberg, and Arvind Narayanan. On the instability of bitcoin without the block reward. In Edgar R. Weippl, Stefan Katzenbeisser, Christopher Kruegel, Andrew C. Myers, and Shai Halevi, editors, _Proceedings of the 2016 ACM SIGSAC Conference on Computer and Communications Security, Vienna, Austria, October 24-28, 2016_, pages 154–167. ACM, 2016. | -| CP19 | Bram Cohen and Krzysztof Pietrzak. The chia network blockchain. 2019. | -| DFKP15 | Stefan Dziembowski, Sebastian Faust, Vladimir Kolmogorov, and Krzysztof Pietrzak. Proofs of space. In Rosario Gennaro and Matthew Robshaw, editors, _Advances in Cryptology - CRYPTO 2015 - 35th Annual Cryptology Conference, Santa Barbara, CA, USA, August 16-20, 2015, Proceedings, Part II, volume 9216 of Lecture Notes in Computer Science_, pages 585–605. Springer, 2015. | -| DKT21 | Soubhik Deb, Sreeram Kannan, and David Tse. Posat: Proof-of-work availability and unpredictability, without the work. In Nikita Borisov and Claudia Diaz, editors, _Financial Cryptography and Data Security - 25th International Conference, FC 2021, Virtual Event, March 1-5, 2021, Revised Selected Papers, Part II, volume 12675 of Lecture Notes in Computer Science_, pages 104–128. Springer, 2021. | -| DW13 | Christian Decker and Roger Wattenhofer. Information propagation in the bitcoin network. In _13th IEEE International Conference on Peer-to-Peer Computing, IEEE P2P 2013, Trento, Italy, September 9-11, 2013_, Proceedings, pages 1–10. IEEE, 2013. | -| EFKP20 | Naomi Ephraim, Cody Freitag, Ilan Komargodski, and Rafael Pass. Continuous verifiable delay functions. In Anne Canteaut and Yuval Ishai, editors, _Advances in Cryptology - EUROCRYPT 2020 - 39th Annual International Conference on the Theory and Applications of Cryptographic Techniques, Zagreb, Croatia, May 10-14, 2020, Proceedings, Part III_, volume 12107 of _Lecture Notes in Computer Science_, pages 125–154. Springer, 2020. | -| ES18 | Ittay Eyal and Emin Gu ̈n Sirer. Majority is not enough: bitcoin mining is vulnerable. _Commun_. ACM, 61(7):95–102, 2018. | -| FZ17 | Lei Fan and Hong-Sheng Zhou. iching: A scalable proof-of-stake blockchain in the open setting (or, how to mimic nakamoto’s design via proof-of-stake). _IACR Cryptol. ePrint Arch._, page 656, 2017. | -| GKL15 | Juan A. Garay, Aggelos Kiayias, and Nikos Leonardos. The bitcoin backbone protocol: Analysis and applications. In Elisabeth Oswald and Marc Fischlin, editors, _Advances in Cryptology - EUROCRYPT 2015 - 34th Annual International Conference on the Theory and Applications of Cryptographic Techniques, Sofia, Bulgaria, April 26-30, 2015, Proceedings, Part II_, volume 9057 of _Lecture Notes in Computer Science_, pages 281–310. Springer, 2015. | -| GKR18 | Peter Gazi, Aggelos Kiayias, and Alexander Russell. Stake-bleeding attacks on proof-of-stake blockchains. In _Crypto Valley Conference on Blockchain Technology, CVCBT 2018, Zug, Switzerland, June 20-22, 2018_, pages 85–92. IEEE, 2018. | -| Hel80 | Martin E. Hellman. A cryptanalytic time-memory trade-off. _IEEE Trans. Inf. Theory_, 26(4):401–406, 1980. | -| Lew21 | Andrew Lewis-Pye. Byzantine generals in the permissionless setting. _CoRR_, abs/2101.07095, 2021. | -| LR21 | Andrew Lewis-Pye and Tim Roughgarden. How does blockchain security dictate blockchain implementation? In Yongdae Kim, Jong Kim, Giovanni Vigna, and Elaine Shi, editors, _CCS ’21: 2021 ACM SIGSAC Conference on Computer and Communications Security, Virtual Event, Republic of Korea, November 15 - 19, 2021_, pages 1006–1019. ACM, 2021. | -| Pie19a | Krzysztof Pietrzak. Proofs of catalytic space. In Avrim Blum, editor, _10th Innovations in Theoretical Computer Science Conference, ITCS 2019, January 10-12, 2019, San Diego, California, USA_, volume 124 of LIPIcs, pages 59:1–59:25. Schloss Dagstuhl - Leibniz- Zentrum für Informatik, 2019. | -| Pie19b | Krzysztof Pietrzak. Simple verifiable delay functions. In Avrim Blum, editor, 1*0th Innovations in Theoretical Computer Science Conference, ITCS 2019, January 10-12, 2019, San Diego, California, USA*, volume 124 of LIPIcs, pages 60:1–60:15. Schloss Dagstuhl - Leibniz-Zentrum fu ̈r Informatik, 2019. | -| PKF+18 | Sunoo Park, Albert Kwon, Georg Fuchsbauer, Peter Gazi, Joël Alwen, and Krzysztof Pietrzak. Spacemint: A cryptocurrency based on proofs of space. In Sarah Meiklejohn and Kazue Sako, editors, _Financial Cryptography and Data Security - 22nd International Conference, FC 2018, Nieuwpoort, Cura ̧cao, February 26 - March 2, 2018, Revised Selected Papers_, volume 10957 of _Lecture Notes in Computer Science_, pages 480–499. Springer, 2018. | -| PS17 | Rafael Pass and Elaine Shi. The sleepy model of consensus. In Tsuyoshi Takagi and Thomas Peyrin, editors, _Advances in Cryptology - ASIACRYPT 2017 - 23rd International Conference on the Theory and Applications of Cryptology and Information Security, Hong Kong, China, December 3-7, 2017, Proceedings, Part II_, volume 10625 of _Lecture Notes in Computer Science_, pages 380–409. Springer, 2017. | -| SNM+21 | Caspar Schwarz-Schilling, Joachim Neu, Barnab ́e Monnot, Aditya Asgaonkar, Ertem Nusret Tas, and David Tse. Three attacks on proof-of-stake ethereum. _IACR Cryptol. ePrint Arch._, page 1413, 2021. | -| SSZ15 | Ayelet Sapirshtein, Yonatan Sompolinsky, and Aviv Zohar. Optimal selfish mining strategies in bitcoin. _CoRR_, abs/1507.06183, 2015. | -| Wes20 | Benjamin Wesolowski. Efficient verifiable delay functions. _J. Cryptol._, 33(4):2113–2147, 2020. | +| Identifier | Publication | +| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| AAC+17 | Hamza Abusalah, Joël Alwen, Bram Cohen, Danylo Khilko, Krzysztof Pietrzak, and Leonid Reyzin. Beyond Hellman’s time-memory trade-offs with applications to proofs of space. In Tsuyoshi Takagi and Thomas Peyrin, editors, _Advances in Cryptology - ASI- ACRYPT 2017 - 23rd International Conference on the Theory and Applications of Cryptology and Information Security, Hong Kong, China, December 3-7, 2017, Proceedings, Part II_, volume 10625 of _Lecture Notes in Computer Science_, pages 357–379. Springer, 2017. | +| BBBF18 | Dan Boneh, Joseph Bonneau, Benedikt Bu ̈nz, and Ben Fisch. Verifiable delay functions. In Hovav Shacham and Alexandra Boldyreva, editors, _Advances in Cryptology - CRYPTO 2018 - 38th Annual International Cryptology Conference, Santa Barbara, CA, USA, August 19-23, 2018, Proceedings, Part I, volume 10991 of Lecture Notes in Computer Science_, pages 757–788. Springer, 2018. | +| BBF18 | Dan Boneh, Benedikt Bu ̈nz, and Ben Fisch. A survey of two verifi- able delay functions. _IACR Cryptol. ePrint Arch._, page 712, 2018. | +| BDK+19 | Vivek Bagaria, Amir Dembo, Sreeram Kannan, Sewoong Oh, David Tse, Pramod Viswanath, Xuechao Wang, and Ofer Zeitouni. Proof- of-stake longest chain protocols: Security vs predictability. 2019. | +| BGK+18 | Christian Badertscher, Peter Gazi, Aggelos Kiayias, Alexander Russell, and Vassilis Zikas. Ouroboros genesis: Composable proof-of-stake blockchains with dynamic availability. In David Lie, Mohammad Mannan, Michael Backes, and XiaoFeng Wang, editors, _Proceedings of the 2018 ACM SIGSAC Conference on Computer and Communications Security, CCS 2018, Toronto, ON, Canada, October 15-19, 2018_, pages 913–930. ACM, 2018. | +| BNPW19 | Jonah Brown-Cohen, Arvind Narayanan, Alexandros Psomas, and S. Matthew Weinberg. Formal barriers to longest-chain proof-of-stake protocols. In Anna Karlin, Nicole Immorlica, and Ramesh Johari, editors, _Proceedings of the 2019 ACM Conference on Economics and Computation, EC 2019, Phoenix, AZ, USA, June 24-28, 2019_, pages 459–473. ACM, 2019. | +| BP22 | Mirza Ahad Baig and Krzysztof Pietrzak. On the existence of proof of space longest chain protocols (working title), 2022. 2022. Manuscript in preparation. | +| CKWN16 | Miles Carlsten, Harry A. Kalodner, S. Matthew Weinberg, and Arvind Narayanan. On the instability of bitcoin without the block reward. In Edgar R. Weippl, Stefan Katzenbeisser, Christopher Kruegel, Andrew C. Myers, and Shai Halevi, editors, _Proceedings of the 2016 ACM SIGSAC Conference on Computer and Communications Security, Vienna, Austria, October 24-28, 2016_, pages 154–167. ACM, 2016. | +| CP19 | Bram Cohen and Krzysztof Pietrzak. The chia network blockchain. 2019. | +| DFKP15 | Stefan Dziembowski, Sebastian Faust, Vladimir Kolmogorov, and Krzysztof Pietrzak. Proofs of space. In Rosario Gennaro and Matthew Robshaw, editors, _Advances in Cryptology - CRYPTO 2015 - 35th Annual Cryptology Conference, Santa Barbara, CA, USA, August 16-20, 2015, Proceedings, Part II, volume 9216 of Lecture Notes in Computer Science_, pages 585–605. Springer, 2015. | +| DKT21 | Soubhik Deb, Sreeram Kannan, and David Tse. Posat: Proof-of-work availability and unpredictability, without the work. In Nikita Borisov and Claudia Diaz, editors, _Financial Cryptography and Data Security - 25th International Conference, FC 2021, Virtual Event, March 1-5, 2021, Revised Selected Papers, Part II, volume 12675 of Lecture Notes in Computer Science_, pages 104–128. Springer, 2021. | +| DW13 | Christian Decker and Roger Wattenhofer. Information propagation in the bitcoin network. In _13th IEEE International Conference on Peer-to-Peer Computing, IEEE P2P 2013, Trento, Italy, September 9-11, 2013_, Proceedings, pages 1–10. IEEE, 2013. | +| EFKP20 | Naomi Ephraim, Cody Freitag, Ilan Komargodski, and Rafael Pass. Continuous verifiable delay functions. Naomi Ephraim, Cody Freitag, Ilan Komargodski, and Rafael Pass. Continuous verifiable delay functions. In Anne Canteaut and Yuval Ishai, editors, _Advances in Cryptology - EUROCRYPT 2020 - 39th Annual International Conference on the Theory and Applications of Cryptographic Techniques, Zagreb, Croatia, May 10-14, 2020, Proceedings, Part III_, volume 12107 of _Lecture Notes in Computer Science_, pages 125–154. Springer, 2020. Springer, 2020. | +| ES18 | Ittay Eyal and Emin Gu ̈n Sirer. Majority is not enough: bitcoin mining is vulnerable. _Commun_. ACM, 61(7):95–102, 2018. | +| FZ17 | Lei Fan and Hong-Sheng Zhou. iching: A scalable proof-of-stake blockchain in the open setting (or, how to mimic nakamoto’s design via proof-of-stake). _IACR Cryptol. ePrint Arch._, page 656, 2017. | +| GKL15 | Juan A. Garay, Aggelos Kiayias, and Nikos Leonardos. The bitcoin backbone protocol: Analysis and applications. In Elisabeth Oswald and Marc Fischlin, editors, _Advances in Cryptology - EUROCRYPT 2015 - 34th Annual International Conference on the Theory and Applications of Cryptographic Techniques, Sofia, Bulgaria, April 26-30, 2015, Proceedings, Part II_, volume 9057 of _Lecture Notes in Computer Science_, pages 281–310. Springer, 2015. | +| GKR18 | Peter Gazi, Aggelos Kiayias, and Alexander Russell. Stake-bleeding attacks on proof-of-stake blockchains. In _Crypto Valley Conference on Blockchain Technology, CVCBT 2018, Zug, Switzerland, June 20-22, 2018_, pages 85–92. IEEE, 2018. | +| Hel80 | Martin E. Hellman. A cryptanalytic time-memory trade-off. _IEEE Trans. Inf. Theory_, 26(4):401–406, 1980. | +| Lew21 | Andrew Lewis-Pye. Byzantine generals in the permissionless setting. _CoRR_, abs/2101.07095, 2021. | +| LR21 | Andrew Lewis-Pye and Tim Roughgarden. How does blockchain security dictate blockchain implementation? In Yongdae Kim, Jong Kim, Giovanni Vigna, and Elaine Shi, editors, _CCS ’21: 2021 ACM SIGSAC Conference on Computer and Communications Security, Virtual Event, Republic of Korea, November 15 - 19, 2021_, pages 1006–1019. ACM, 2021. | +| Pie19a | Krzysztof Pietrzak. Proofs of catalytic space. In Avrim Blum, editor, _10th Innovations in Theoretical Computer Science Conference, ITCS 2019, January 10-12, 2019, San Diego, California, USA_, volume 124 of LIPIcs, pages 59:1–59:25. Schloss Dagstuhl - Leibniz- Zentrum für Informatik, 2019. | +| Pie19b | Krzysztof Pietrzak. Simple verifiable delay functions. In Avrim Blum, editor, 1*0th Innovations in Theoretical Computer Science Conference, ITCS 2019, January 10-12, 2019, San Diego, California, USA*, volume 124 of LIPIcs, pages 60:1–60:15. Schloss Dagstuhl - Leibniz-Zentrum fu ̈r Informatik, 2019. | +| PKF+18 | Sunoo Park, Albert Kwon, Georg Fuchsbauer, Peter Gazi, Joël Alwen, and Krzysztof Pietrzak. Spacemint: A cryptocurrency based on proofs of space. In Sarah Meiklejohn and Kazue Sako, editors, _Financial Cryptography and Data Security - 22nd International Conference, FC 2018, Nieuwpoort, Cura ̧cao, February 26 - March 2, 2018, Revised Selected Papers_, volume 10957 of _Lecture Notes in Computer Science_, pages 480–499. Springer, 2018. | +| PS17 | Rafael Pass and Elaine Shi. The sleepy model of consensus. Rafael Pass and Elaine Shi. The sleepy model of consensus. In Tsuyoshi Takagi and Thomas Peyrin, editors, _Advances in Cryptology - ASIACRYPT 2017 - 23rd International Conference on the Theory and Applications of Cryptology and Information Security, Hong Kong, China, December 3-7, 2017, Proceedings, Part II_, volume 10625 of _Lecture Notes in Computer Science_, pages 380–409. Springer, 2017. Springer, 2017. | +| SNM+21 | Caspar Schwarz-Schilling, Joachim Neu, Barnab ́e Monnot, Aditya Asgaonkar, Ertem Nusret Tas, and David Tse. Three attacks on proof-of-stake ethereum. _IACR Cryptol. ePrint Arch._, page 1413, 2021. | +| SSZ15 | Ayelet Sapirshtein, Yonatan Sompolinsky, and Aviv Zohar. Optimal selfish mining strategies in bitcoin. _CoRR_, abs/1507.06183, 2015. | +| Wes20 | Benjamin Wesolowski. Efficient verifiable delay functions. _J. Cryptol._, 33(4):2113–2147, 2020. | ## Additional Reading diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md index 8f6a61aeb8..e4c010e737 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md @@ -12,9 +12,7 @@ A key ingredient in longest-chain blockchains are hash-chains as discussed in § For this writeup, a _hash chain_ is a sequence $b_0,b_1,b_2\ldots$ of blocks, where each block $b_i=\{h_i,x_i\}$ contains some data value $x_i$ (possibly empty) and (with the exception of $b_0$) a hash value of the current data and the previous block. -$$ -h_i:={\sf H}(b_{i-1},x_i) -$$ +$$ h_i:={\sf H}(b_{i-1},x_i) $$ #### Security from hash chains. @@ -22,7 +20,7 @@ A hash chain is immutable in the following sense: --- -**Proposition 2** (immutability of hash chains). _If ${\sf H}$ is a collision-resistant hash function, then it is computationally infeasible to find two distinct hash chains ${\cal H}=b_0,\ldots.b_i$ and ${\cal H'}=b'_0,\ldots,b'_j$ where $h_i=h'_j$ and no chain is a prefix of the other (which holds if they start with the same $x_0=x'_0$)._ +**Proposition 2** (immutability of hash chains). **Proposition 2** (immutability of hash chains). _If ${\sf H}$ is a collision-resistant hash function, then it is computationally infeasible to find two distinct hash chains ${\cal H}=b_0,\ldots.b_i$ and ${\cal H'}=b'_0,\ldots,b'_j$ where $h_i=h'_j$ and no chain is a prefix of the other (which holds if they start with the same $x_0=x'_0$)._ --- @@ -36,8 +34,7 @@ A hash chain is immutable in the following sense: A VDF chain is a sequence $$ -{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell -$$ +{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell $$
eq.(5)
@@ -49,15 +46,13 @@ $$ and the challenge for the $i$th VDF is derived from the previous VDF output (except for $i=1$) and data value -$$ -\tau_1.c := \mathsf{VDF.sample}(z_0) \quad \text{ and } \quad \forall i > 1 : \tau_i.\mathsf{c} := \mathsf{VDF.sample}(\tau_{i-1}.\mathsf{y}, z_{i-1}) -$$ +$$ \tau_1.c := \mathsf{VDF.sample}(z_0) \quad \text{ and } \quad \forall i > 1 : \tau_i.\mathsf{c} := \mathsf{VDF.sample}(\tau_{i-1}.\mathsf{y}, z_{i-1}) $$ where we use the convention that $\tau_0.{\sf y}$ is the empty string. ### 4.2.1 Notation for VDF chains -We naturally extend the notion for VDFs as described in §A.3 to VDF chains. The _total number of VDF steps in a VDF chain_ as in eq.(5) is simply the sum of the steps in its VDFs +We naturally extend the notion for VDFs as described in §A.3 to VDF chains. We naturally extend the notion for VDFs as described in §A.3 to VDF chains. The _total number of VDF steps in a VDF chain_ as in eq.(5) is simply the sum of the steps in its VDFs $$ {\cal V}.{\sf t}\stackrel{\scriptsize \sf def}{=}\sum_{i=1}^\ell \tau_i.{\sf t} @@ -69,14 +64,15 @@ VDF chains give two basic security guarantees, the first is immutability analogo --- -**Proposition 3** (immutability and sequentiality of VDF chains). *Like a hash chain, a VDF chain is *immutable* in the sense that it's computationally infeasible to come up with two different VDF chains* +**Proposition 3** (immutability and sequentiality of VDF chains). **Proposition 3** (immutability and sequentiality of VDF chains). *Like a hash chain, a VDF chain is *immutable* in the sense that it's computationally infeasible to come up with two different VDF chains* $$ +{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell \qquad {\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell \qquad {\cal V}'=z'_0,\tau'_1,z'_1,\tau'_2,z'_2,\ldots,\tau'_{\ell'} $$ -where the last VDF outputs collide, i.e., $\tau_\ell.{\sf y}=\tau'_{\ell'}.{\sf y}$. Here different means that either they have different length $\ell\neq \ell'$ and neither is a prefix of the other. Or (if $\ell=\ell'$) there exists an $i$ s.t. either $z_i\neq z'_i$ or $\tau_i.{\sf y}\neq \tau'_i.{\sf y}$ or $\tau.{\sf t}\neq \tau'.{\sf t}$. Note that we ignore the proofs $\tau.\pi$ when comparing chains (we just use them to determine whether the chain is valid) as they must not be unique. +where the last VDF outputs collide, i.e., $\tau_\ell.{\sf y}=\tau'_{\ell'}.{\sf y}$. Here different means that either they have different length $\ell\neq \ell'$ and neither is a prefix of the other. Or (if $\ell=\ell'$) there exists an $i$ s.t. either $z_i\neq z'_i$ or $\tau_i.{\sf y}\neq \tau'_i.{\sf y}$ or $\tau.{\sf t}\neq \tau'.{\sf t}$. Note that we ignore the proofs $\tau.\pi$ when comparing chains (we just use them to determine whether the chain is valid) as they must not be unique. Here different means that either they have different length $\ell\neq \ell'$ and neither is a prefix of the other. Or (if $\ell=\ell'$) there exists an $i$ s.t. either $z_i\neq z'_i$ or $\tau_i.{\sf y}\neq \tau'_i.{\sf y}$ or $\tau.{\sf t}\neq \tau'.{\sf t}$. Note that we ignore the proofs $\tau.\pi$ when comparing chains (we just use them to determine whether the chain is valid) as they must not be unique. -Moreover a VDF chain is _sequential_, meaning that not only the individual VDFs must be computed sequentially (which follows from the security definition of VDFs), but also the VDFs in the chain were computed sequentially. I.e., computing a chain ${\cal V}$ as above requires $\sum_{i=1}^\ell \tau_i.{\sf t}$ sequential steps. +Moreover a VDF chain is _sequential_, meaning that not only the individual VDFs must be computed sequentially (which follows from the security definition of VDFs), but also the VDFs in the chain were computed sequentially. I.e., computing a chain ${\cal V}$ as above requires $\sum_{i=1}^\ell \tau_i.{\sf t}$ sequential steps. I.e., computing a chain ${\cal V}$ as above requires $\sum_{i=1}^\ell \tau_i.{\sf t}$ sequential steps. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/longest-chain-protocols.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/longest-chain-protocols.md index dc5744e42d..594a54c6dd 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/longest-chain-protocols.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/longest-chain-protocols.md @@ -8,7 +8,7 @@ slug: /longest-chain-protocols Before we can outline the specification of the $\textrm{{\sf Chia}}$ blockchain and its rationale in more detail, we first must understand the general challenges one faces when constructing a PoSpace based blockchain and some of the relevant literature on how to address these challenges. -Ultimately, we want to argue security assuming only that sufficient fraction of the resource (space, fast VDFs) is controlled by _rational_ parties. Towards this, in this Section we first discuss how to achieve security assuming sufficiently many parties are _honest_, and then in §3 how _rational_ behavior is incentivized by ensuring that deviating from the protocol will not give any (or very little) extra reward to parties. +Ultimately, we want to argue security assuming only that sufficient fraction of the resource (space, fast VDFs) is controlled by _rational_ parties. Towards this, in this Section we first discuss how to achieve security assuming sufficiently many parties are _honest_, and then in §3 how _rational_ behavior is incentivized by ensuring that deviating from the protocol will not give any (or very little) extra reward to parties. Towards this, in this Section we first discuss how to achieve security assuming sufficiently many parties are _honest_, and then in §3 how _rational_ behavior is incentivized by ensuring that deviating from the protocol will not give any (or very little) extra reward to parties.
alt text @@ -21,7 +21,7 @@ As mentioned in the introduction, just replacing proofs of work in Bitcoin with In longest-chain blockchains the challenge used to determine the miner/farmer who can add a block is derived from the chain itself. In Bitcoin, where the challenge for a block is simply the hash of the previous block, a miner can influence the PoW challenge by trying out different transaction sets or time stamps. While such "grinding" through different challenges gives no advantage in PoW based cryptocurrencies, it's a problem once we use an efficient proof system. -To prevent such grinding we adopt an approach from Spacemint [PKF+18] and _split the chain_ in two parts which we'll call trunk and foliage. The trunk contains only canonical proofs, and the challenges depend only on values contained in the trunk. This way the only choice a farmer has to influence the challenge is by withholding a winning block. The foliage contains all the remaining "grindeable" content, in particular transactions and time-stamps. +To prevent such grinding we adopt an approach from Spacemint [PKF+18] and _split the chain_ in two parts which we'll call trunk and foliage. The trunk contains only canonical proofs, and the challenges depend only on values contained in the trunk. This way the only choice a farmer has to influence the challenge is by withholding a winning block. The foliage contains all the remaining "grindeable" content, in particular transactions and time-stamps. The trunk contains only canonical proofs, and the challenges depend only on values contained in the trunk. This way the only choice a farmer has to influence the challenge is by withholding a winning block. The foliage contains all the remaining "grindeable" content, in particular transactions and time-stamps. ## 2.2 Double-Dipping @@ -29,7 +29,7 @@ Even once grinding is no longer an option, an adversary can in private create an To limit the impact of double-dipping an early version [CP19] of $\textrm{{\sf Chia}}$ consensus specified that also the honest parties do a very limited form of double-dipping and try to extend the best $3$ blocks they see at every depth, this rule was (by simulations) shown to increase the space required by an adversary from the $26.9\%$ mentioned above, to $38.5\%$. -The deployed $\textrm{{\sf Chia}}$ protocol uses _correlated randomness_ to limit the impact of double dipping. This elegant idea was introduced in [BDK+19], and basically suggest to only use every $k$th block to compute the challenges.[^1] The authors of [BDK+19] determine the exact fraction of the _resource_ the adversary must control to break security as a function of $k$ (as mentioned, it's $2.718$ for $k=1$, and goes to $1$ as $k$ increases). $\textrm{{\sf Chia}}$ uses a variant where a challenge depends on one out of _at least_ (not exactly) $k=16$ blocks. Their analysis also applies to this setting, and with $k=16$ states that by double dipping the adversary can boost their resource by a factor of $1.47$, which means they must control at least a $\frac{1}{1+1.47}=0.405$ fraction of the resource for an attack. +The deployed $\textrm{{\sf Chia}}$ protocol uses _correlated randomness_ to limit the impact of double dipping. The deployed $\textrm{{\sf Chia}}$ protocol uses _correlated randomness_ to limit the impact of double dipping. This elegant idea was introduced in [BDK+19], and basically suggest to only use every $k$th block to compute the challenges.[^1] The authors of [BDK+19] determine the exact fraction of the _resource_ the adversary must control to break security as a function of $k$ (as mentioned, it's $2.718$ for $k=1$, and goes to $1$ as $k$ increases). $\textrm{{\sf Chia}}$ uses a variant where a challenge depends on one out of _at least_ (not exactly) $k=16$ blocks. Their analysis also applies to this setting, and with $k=16$ states that by double dipping the adversary can boost their resource by a factor of $1.47$, which means they must control at least a $\frac{1}{1+1.47}=0.405$ fraction of the resource for an attack. $\textrm{{\sf Chia}}$ uses a variant where a challenge depends on one out of _at least_ (not exactly) $k=16$ blocks. Their analysis also applies to this setting, and with $k=16$ states that by double dipping the adversary can boost their resource by a factor of $1.47$, which means they must control at least a $\frac{1}{1+1.47}=0.405$ fraction of the resource for an attack. The resource considered in [BDK+19] is simply stake, while in $\textrm{{\sf Chia}}$ it's the product of space and VDF speed. Concerning VDFs, while for the honest parties the only thing that matters is the _speed_ of the three VDFs controlled by the fastest honest time lord, for an adversary the speed as well as the number of VDFs available to them matter. In the security analysis we can simply assume the adversary controls an unbounded number of VDFs, as that's when the analysis from [BDK+19] applies. This is how eq.(2) $space_h\cdot vdf_h > space_a \cdot vdf_a \cdot 1.47$ in §1.1 was derived. @@ -44,6 +44,6 @@ A major issue with longest-chain blockchains based on efficient proof systems i Existing proposals to achieve security under such _dynamic availability_ include check-pointing, which is problematic as parties that join for the first time or have not followed the chain for a longer period need additional trust assumptions to decide which chain to follow. Unlike for grinding and double-dipping, the attacks that become possible due to bootstrapping are quite different for proofs of space and proofs of stake. In the latter one must consider old keys that hold no stake in the current chain, but still can be used to bootstrap from a past block. To address this it was suggested to have honest parties use key-evolution schemes [BGK+18] so the current keys cannot be used to create blocks in the past. Key-evolution is problematic as it's clearly not rational for honest parties to do; they could sell their keys or lose their stake in case of a deep reorg. -The essence of the bootstrapping problem is the fact that one cannot ensure that time has passed in-between the creation of subsequent blocks. $\textrm{{\sf Chia}}$ solves this problem by combining proofs of space with _proofs of time_, concretely, verifiable delay functions (VDFs), which enforce that some inherently sequential computation (which requires time linear in the length of the computation) was performed in-between the creation of blocks. $\textrm{{\sf Chia}}$ combines those three countermeasures (splitting the chain, correlated randomness and proofs of time) into a single design which is secure if the resources controlled by the honest parties satisfy the bound from Eq. +The essence of the bootstrapping problem is the fact that one cannot ensure that time has passed in-between the creation of subsequent blocks. The essence of the bootstrapping problem is the fact that one cannot ensure that time has passed in-between the creation of subsequent blocks. $\textrm{{\sf Chia}}$ solves this problem by combining proofs of space with _proofs of time_, concretely, verifiable delay functions (VDFs), which enforce that some inherently sequential computation (which requires time linear in the length of the computation) was performed in-between the creation of blocks. $\textrm{{\sf Chia}}$ combines those three countermeasures (splitting the chain, correlated randomness and proofs of time) into a single design which is secure if the resources controlled by the honest parties satisfy the bound from Eq. $\textrm{{\sf Chia}}$ combines those three countermeasures (splitting the chain, correlated randomness and proofs of time) into a single design which is secure if the resources controlled by the honest parties satisfy the bound from Eq. [^1]: Using the same challenge for $k>1$ blocks has already been suggested in [PKF+18], but this is a different requirement (as the challenge can still depend on all blocks) and adds much less security than correlated randomness for small $k$. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md index 551137c968..c26f12b576 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md @@ -8,9 +8,9 @@ slug: /rational-attackers In §2 we discussed how costless simulation opens attack vectors for double spending in longest-chain blockchains and how these are addressed in $\textrm{{\sf Chia}}$. To show security we assumed that a sufficient fraction of the resource is controlled by _honest_ parties who follow the protocol rules. In reality it's unrealistic to assume that parties will behave altruistically, instead we need to argue that it's _rational_ for parties to follow the protocol rules. Unfortunately costless simulation also makes this task much more challenging than in a PoW based system. -In analogy to _selfish mining_ in Bitcoin, we refer to strategies by which a party gets more rewards than they would by following the protocol rules as _selfish farming_. To argue that rational parties will behave honestly it's necessary to bound the efficacy of selfish mining/farming strategies. +In analogy to _selfish mining_ in Bitcoin, we refer to strategies by which a party gets more rewards than they would by following the protocol rules as _selfish farming_. To argue that rational parties will behave honestly it's necessary to bound the efficacy of selfish mining/farming strategies. To argue that rational parties will behave honestly it's necessary to bound the efficacy of selfish mining/farming strategies. -In §3.1 below we first discuss selfish mining and why we don't observe it in Bitcoin even though it's possible in principle. As directly analyzing the security of a longest-chain protocol against selfish mining/farming is very challenging we take a modular approach. In §3.2 we first identify two properties – _no slowdown_ and _delayed gratification_ illustrated in Figure 5 – which are satisfied by Bitcoin, and then show in §3.3 that they imply robustness against selfish mining (through the notion of chain quality) of the level as achieved by Bitcoin. In §3.4 and §3.5 we then sketch how those notions are achieved in $\textrm{{\sf Chia}}$. +In §3.1 below we first discuss selfish mining and why we don't observe it in Bitcoin even though it's possible in principle. As directly analyzing the security of a longest-chain protocol against selfish mining/farming is very challenging we take a modular approach. In §3.1 below we first discuss selfish mining and why we don't observe it in Bitcoin even though it's possible in principle. As directly analyzing the security of a longest-chain protocol against selfish mining/farming is very challenging we take a modular approach. In §3.2 we first identify two properties – _no slowdown_ and _delayed gratification_ illustrated in Figure 5 – which are satisfied by Bitcoin, and then show in §3.3 that they imply robustness against selfish mining (through the notion of chain quality) of the level as achieved by Bitcoin. In §3.4 and §3.5 we then sketch how those notions are achieved in $\textrm{{\sf Chia}}$. In §3.4 and §3.5 we then sketch how those notions are achieved in $\textrm{{\sf Chia}}$. ## 3.1 Selfish Mining in Bitcoin @@ -26,25 +26,25 @@ While Bitcoin prevents double spending assuming a majority of the hashing power The Bitcoin blockchain is split in epochs, each with a targeted duration of two weeks, and only at the end of an epoch the difficulty is reset to accommodate for the variation of the hashing power. Assuming the network is reliable, within an epoch, a selfish miner cannot create more blocks than they would get by honest mining. This follows from a crucial property of proofs of work: there's no way to find more proofs of a given difficulty (and thus blocks) in a given time window than simply following the protocol and always working on the known longest chain. The only thing selfish mining does in Bitcoin is to make honest parties waste their hashing power, so after the next difficulty reset (which only happens every 2 weeks) the difficulty is lower than it should be, and only at this point the selfish miner makes some extra profit. Another property of PoW based chains like Bitcoin is that an adversary cannot slow down chain growth. We capture these two desirable properties separately below. -**Delayed Gratification:** A chain where an adversary cannot increase the number of blocks they find in expectation within an epoch of same difficulty by deviating from the honest strategy is said to have the _delayed gratification_ property. In $\textrm{{\sf Chia}}$, by "not deviating" we mean that the adversary simply runs an honest farmer using its available space, and additionally, should the adversary control VDFs that are faster than the fastest honest time lord, they are also assumed to run a time lord. Intuitively, delayed gratification is a good deterrent to selfish mining by itself as it limits selfish mining to adversaries who follow a "long term" agenda. +**Delayed Gratification:** A chain where an adversary cannot increase the number of blocks they find in expectation within an epoch of same difficulty by deviating from the honest strategy is said to have the _delayed gratification_ property. In $\textrm{{\sf Chia}}$, by "not deviating" we mean that the adversary simply runs an honest farmer using its available space, and additionally, should the adversary control VDFs that are faster than the fastest honest time lord, they are also assumed to run a time lord. Intuitively, delayed gratification is a good deterrent to selfish mining by itself as it limits selfish mining to adversaries who follow a "long term" agenda. In $\textrm{{\sf Chia}}$, by "not deviating" we mean that the adversary simply runs an honest farmer using its available space, and additionally, should the adversary control VDFs that are faster than the fastest honest time lord, they are also assumed to run a time lord. Intuitively, delayed gratification is a good deterrent to selfish mining by itself as it limits selfish mining to adversaries who follow a "long term" agenda. **No Slowdown:** A chain where an adversary (no matter what fraction of the resource they control) cannot slow down the expected block arrival time by interacting with the chain is said to have the _no slowdown_ property. ## 3.3 Chain Quality -A longest-chain blockchain is said to have _chain quality_ $\rho$ if the fraction of blocks mined by honest miners is at least $\rho$ (with high probability and considering a sufficiently large number of blocks). Chain quality was introduced in [GKL15] as a metric to quantify how susceptible a chain is to selfish mining. Ideally, assuming an adversarial miner who controls an $\alpha$ fraction of the resource, the chain quality should be $\rho=1-\alpha$ as this means that the adversary cannot increase its fraction of blocks by deviating. +A longest-chain blockchain is said to have _chain quality_ $\rho$ if the fraction of blocks mined by honest miners is at least $\rho$ (with high probability and considering a sufficiently large number of blocks). Chain quality was introduced in [GKL15] as a metric to quantify how susceptible a chain is to selfish mining. Ideally, assuming an adversarial miner who controls an $\alpha$ fraction of the resource, the chain quality should be $\rho=1-\alpha$ as this means that the adversary cannot increase its fraction of blocks by deviating. Chain quality was introduced in [GKL15] as a metric to quantify how susceptible a chain is to selfish mining. Ideally, assuming an adversarial miner who controls an $\alpha$ fraction of the resource, the chain quality should be $\rho=1-\alpha$ as this means that the adversary cannot increase its fraction of blocks by deviating. By the Proposition below delayed gratification and the no slowdown property imply a bound on _chain quality_ which matches the bound proven for Bitcoin (when ignoring network delays). --- -**Proposition 1** (Delayed Gratification and No Slowdown implies Chain Quality). _Consider a longest-chain protocol which has the delayed gratification and no slowdown property against an adversary who controls an $\alpha$ fraction of the global resource, then the chain quality is $1-\frac{\alpha}{1-\alpha}$ (compared to the ideal $1-\alpha$)._ +**Proposition 1** (Delayed Gratification and No Slowdown implies Chain Quality). **Proposition 1** (Delayed Gratification and No Slowdown implies Chain Quality). _Consider a longest-chain protocol which has the delayed gratification and no slowdown property against an adversary who controls an $\alpha$ fraction of the global resource, then the chain quality is $1-\frac{\alpha}{1-\alpha}$ (compared to the ideal $1-\alpha$)._ -_Proof._ Consider an adversarial miner ${\cal A}$ with an $\alpha$ fraction of the resource and let $\ell$ denote the (expected) number of blocks to be found if everyone would mine honestly. By the no slowdown property, no matter what ${\cal A}$ does the number of blocks found is at least $\ell'\ge (1-\alpha)\cdot\ell$. By delayed gratification, at most $\alpha\cdot\ell$ of those blocks were created by ${\cal A}$, we get a chain quality of +_Proof._ Consider an adversarial miner ${\cal A}$ with an $\alpha$ fraction of the resource and let $\ell$ denote the (expected) number of blocks to be found if everyone would mine honestly. By the no slowdown property, no matter what ${\cal A}$ does the number of blocks found is at least $\ell'\ge (1-\alpha)\cdot\ell$. By delayed gratification, at most $\alpha\cdot\ell$ of those blocks were created by ${\cal A}$, we get a chain quality of By the no slowdown property, no matter what ${\cal A}$ does the number of blocks found is at least $\ell'\ge (1-\alpha)\cdot\ell$. By delayed gratification, at most $\alpha\cdot\ell$ of those blocks were created by ${\cal A}$, we get a chain quality of -$$ -\begin{aligned} \textit{chain quality}&=\frac{\text{honest blocks}}{\text{total blocks}}\\ &=\frac{\ell' - \alpha \cdot \ell}{\ell'}\\ &=1-\frac{\alpha\cdot\ell}{\ell'}\\ &\ge 1-\frac{\alpha\cdot\ell}{(1-\alpha)\cdot \ell}\\ &=1-\frac{\alpha}{1-\alpha} \hspace{10em}\square \end{aligned} -$$ +$$ \begin{aligned} \textit{chain quality}&=\frac{\text{honest blocks}}{\text{total blocks}}\\ +&=\frac{\ell' - \alpha \cdot \ell}{\ell'}\\ &=1-\frac{\alpha\cdot\ell}{\ell'}\\ +&\ge 1-\frac{\alpha\cdot\ell}{(1-\alpha)\cdot \ell}\\ &=1-\frac{\alpha}{1-\alpha} \hspace{10em}\square \end{aligned} $$ --- @@ -113,7 +113,7 @@ For example the difference in the $g$-greedy and the $D$-distance greedy protoco Unlike the chain specification, which can only be changed by a hard fork once the chain is deployed, the chain selection rule can easily be adapted by the farmers and/or time lords even after the launch. Finding a chain-selection rule for the $\textsf{Chia}$ chain which provably achieves no-slowdown is an interesting open problem. -Under the additional assumption that an adversary does not control VDFs which are _faster_ than the fastest honest time lord, a very simple chain selection rule achieving no-slowdown exists: always follow the chain with accumulated most VDF steps. Of course this rule would be terrible in practice as security completely breaks if the adversary has an even slightly faster VDF than the fastest honest time lord. For example, such an adversary could create an "empty" chain by refusing to infuse any blocks. +Under the additional assumption that an adversary does not control VDFs which are _faster_ than the fastest honest time lord, a very simple chain selection rule achieving no-slowdown exists: always follow the chain with accumulated most VDF steps. Of course this rule would be terrible in practice as security completely breaks if the adversary has an even slightly faster VDF than the fastest honest time lord. For example, such an adversary could create an "empty" chain by refusing to infuse any blocks. Of course this rule would be terrible in practice as security completely breaks if the adversary has an even slightly faster VDF than the fastest honest time lord. For example, such an adversary could create an "empty" chain by refusing to infuse any blocks. A more sensible rule is to simply follow the _heaviest_ fork like in Bitcoin. Unfortunately, unlike in Bitcoin, in $\textsf{Chia}$ the heaviest fork is not necessarily the fork which will be heaviest in the future assuming all honest parties adapt it: a fork $A$ might have one more block infused than some fork $B$, but if $B$ is way ahead in the VDF computation extending $B$ might give a better chain (in expectation) in the future. Thus, when using this rule, by releasing $B$ an adversary might slow down the chain. The currently deployed chain selection rule for farmers and time lords is basically to follow the heaviest fork, but with some heuristics to avoid clear cases where switching to a heavier chain is slowing down growth. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md index c80a4ab305..8b20242a42 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md @@ -10,11 +10,15 @@ In this Section we have a look at two closely related security properties of lon We discussed in §2 the main security issues of a PoSpace based longest-chain blockchain arise from the fact that PoSpace is an efficient proof system. PoSpace shares those security challenges with PoStake, and all three countermeasures summarized in Figure 3 (namely splitting the chain to prevent grinding, correlated randomness to prevent double-dipping and using VDFs to prevent bootstrapping) can readily be applied in the stake setting, correlated randomness was even originally proposed for stake [BDK+19]. But as we'll discuss below, when it comes to security under dynamic availability or 51% attacks there are fundamental differences between space and stake. In particular, using proofs of space in combination with VDFs one can handle both attacks basically as well as with proofs of work, while proofs of stake cannot, even in combination with VDFs. +{' '} +
+ ![](/img/green-paper/table-1.png)
Table 1: Summary of the ability to heal from malicious majority and provide security under dynamic availability of longest-chain protocols based various proof systems. -
+ +
## 6.1 Recovery from $51\%$ Attacks @@ -27,31 +31,31 @@ There's also a key difference between PoStake and PoSpace. By using VDFs in addi While Bitcoin provides no security if more than half of the hashrate is controlled by an adversary, it is "self-healing" in the sense that once the majority of the hashrate is again controlled by honest parties, Bitcoin regains (after some delay) all its security properties. -A bit more formally, let ${\sf PoW}_h(t)$ and ${\sf PoW}_a(t)$ denote the hashing power of the honest and adversarial parties at clock time $t$, respectively. For $t_0eq.(11)
+
eq.(11)
If this holds the adversary can simply start at time $t_0$ to mine a chain in private, and release it at time $t_1$. By the first inequality the adversaries chain will be heavier than the honest one with probability at least $0.5$, and by the 2nd the honest block added at time $t$ will be buried by $k$ blocks with probability $0.5$, so both hold and we have a successful double spending attack with probability at least $\approx 0.5^2=0.25$ (it can actually be a bit less than that as the two events are negatively correlated). To be secure it's not sufficient that no $t_0,t_1$ as in eq.(11) exist, but one needs to be "sufficiently far" from this situation to guarantee that double spending can only happen with some tiny probability. From the standard Chernoff bound it follows that the probability that a fork starting at a block added at time $t_0$ and being released at time $t_1$ will be successful (i.e., have higher weight than the honest chain) is exponentially small in the number of expected honest blocks ${\sf PoW}_h(t_0,t_1)/D$ and the square of the honest to adversarial advantage, i.e., -$$ -\begin{aligned} &\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ &\le -\exp\left(\frac{\mathsf{PoW}_h(t_0,t_1)}{D} \cdot\left( \frac{\mathsf{PoW}_h(t_0,t_1)}{\mathsf{PoW}_a(t_0,t_1)}-1 \right)^2\right) \end{aligned} -$$ +$$ \begin{aligned} &\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ +&\le -\exp\left(\frac{\mathsf{PoW}_h(t_0,t_1)}{D} \cdot\left( \frac{\mathsf{PoW}_h(t_0,t_1)}{\mathsf{PoW}_a(t_0,t_1)}-1 \right)^2\right) \end{aligned} $$ -
eq.(12)
+
eq.(12)
### 6.1.2 Recovering from PoStake Majority @@ -65,11 +69,11 @@ A longest-chain protocol using only PoSpace (like Spacemint [eq.(13)
+
eq.(13)
A difference to the PoW setting is the additional $1.47$ factor boosting the adversary's resource which is necessary to account for the fact that they can do some bounded double dipping. @@ -108,18 +110,16 @@ A blockchain based on some resource is _secure under dynamic availability_ if it Using notation from §6.1.1, for a PoW based chain that means that for some $f>1$ (that captures the advantage of the honest parties) and any time $t$ we have $$ -{\sf PoW}_a(t)\le f\cdot {\sf PoW}_h(t) -$$ +{\sf PoW}_a(t)\le f\cdot {\sf PoW}_h(t) $$ -
eq.(14)
+
eq.(14)
To see that Bitcoin is secure under dynamic availability we can reuse our inequality eq.(12) which using $\frac{{\sf PoW}_h(t_0,t_1)}{{\sf PoW}_a(t_0,t_1)}\ge f$ simplifies to (recall that $\frac{{\sf PoW}_h(t_0,t_1)}{D}$ is the expected number of honest blocks in the $t_0$ to $t_1$ window) -$$ -\begin{aligned} &\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ &\le -\exp\left(\frac{\mathsf{PoW}_h(t_0,t_1)}{D} \cdot\left(f-1 \right)^2\right) \end{aligned} -$$ +$$ \begin{aligned} &\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ +&\le -\exp\left(\frac{\mathsf{PoW}_h(t_0,t_1)}{D} \cdot\left(f-1 \right)^2\right) \end{aligned} $$ -
eq.(15)
+
eq.(15)
Which simply means that the probability that an adversary will be able to create any particular a fork decreases exponentially in the length of the fork. @@ -128,18 +128,16 @@ Which simply means that the probability that an adversary will be able to create Analogously to PoW just outlined, and using notation from §6.1.4 we can define dynamic availability for PoST as used in $\textsf{Chia}$ by requiring that at any time $t$ $$ -{\sf PoST}_a(t)\le f\cdot {\sf PoST}_h(t) -$$ +{\sf PoST}_a(t)\le f\cdot {\sf PoST}_h(t) $$ -
eq.(16)
+
eq.(16)
With this eq.(13) becomes -$$ -\begin{aligned} &\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ &\le -\exp\left(\frac{\mathsf{PoST}_h(t_0,t_1)}{D} \cdot\left( \frac{f}{1.47}-1 \right)^2\right) \end{aligned} -$$ +$$ \begin{aligned} &\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ +&\le -\exp\left(\frac{\mathsf{PoST}_h(t_0,t_1)}{D} \cdot\left( \frac{f}{1.47}-1 \right)^2\right) \end{aligned} $$ -
eq.(17)
+
eq.(17)
Thus like in Bitcoin, in $\textsf{Chia}$ the probability of a successful fork decreases exponentially fast in the length of the fork. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/the-chia-blockchain.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/the-chia-blockchain.md index 908e7b6e5e..ddd1c35d46 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/the-chia-blockchain.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/the-chia-blockchain.md @@ -19,11 +19,11 @@ In this section we finally outline the design of the $\textsf{Chia}$ blockchain ### 5.1.1 Variables -| 变量 | Definition | -| ---------------- | -------------------------------------------------------------------------------------------------------------------------- | -| $T_i$ | Time parameter of $i$-th slot (# of VDF steps per sub-slot). Recalibrated once per day for 10 minutes per sub-slot target. | -| $\mathsf{spi}_i$ | $$\mathsf{spi}_i \stackrel{\text{\tiny def}}{=} \frac{T_i}{64}$$ | -| $D_i$ | Difficulty parameter of $i$-th slot. Recalibrated once per day for 32 blocks per slot target | +| 变量 | Definition | +| ----------------- | -------------------------------------------------------------------------------------------------------------------------- | +| $T_i$ | Time parameter of $i$-th slot (# of VDF steps per sub-slot). Recalibrated once per day for 10 minutes per sub-slot target. | +| $\mathsf{spi}_i$ | $$\mathsf{spi}_i \stackrel{\text{\tiny def}}{=} \frac{T_i}{64}$$ | +| $D_i$ | Difficulty parameter of $i$-th slot. Recalibrated once per day for 32 blocks per slot target | ### 5.1.2 Step to Epoch @@ -35,71 +35,62 @@ To describe the $\textsf{Chia}$ chains it will be convenient to introduce some The VDF chains we'll consider (${\cal RC}$ and ${\cal CC}$) will be split into slots where the starting point of a new slot will always be an infusion point. For a point ${\sf point}={\cal V}[t]$ on such a chain we denote with -| Point | Definition | -| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ${\sf point}.{\sf D}$ | the total depth, i.e., the number of steps of this point since genesis | -| ${\sf point}.{\sf d}$ | the depth of this point in the current slot | -| ${\sf point}.{\sf t}$ | the depth of this point in its VDF | -| ${\sf point}.{\sf x}$ | the value of the VDF chain at this point | -| ${\sf point}.\pi$ | a proof certifying the VDF computation up to this point | -| ${\sf point}^+$ | If ${\sf point}$ is an infusion point where some value $v$ gets infused, then we denote with ${\sf point}$ the point before infusion, and with $${\sf point}^+ = {\sf VDF.sample}({\sf point}.{\sf x},v)$$ the point after infusion | +| Point | Definition | +| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ${\sf point}.{\sf D}$ | the total depth, i.e., the number of steps of this point since genesis | +| ${\sf point}.{\sf d}$ | the depth of this point in the current slot | +| ${\sf point}.{\sf t}$ | the depth of this point in its VDF | +| ${\sf point}.{\sf x}$ | the value of the VDF chain at this point | +| ${\sf point}.\pi$ | a proof certifying the VDF computation up to this point | +| ${\sf point}^+$ | If ${\sf point}$ is an infusion point where some value $v$ gets infused, then we denote with ${\sf point}$ the point before infusion, and with $${\sf point}^+ = {\sf VDF.sample}({\sf point}.{\sf x},v)$$ the point after infusion | The following points on the $\textsf{Chia}$ VDF chains will be defined -| Point | Definition | -| --------------------- | ------------------------------------------------------------------------------------------ | -| ${\sf cc\_sp}_{i,j}$ | The $j$th **challenge chain signage point** in the $i$th slot (eq.(6)) | -| ${\sf rc\_sp}_{i,j}$ | The $j$th **reward chain signage point** in the $i$th slot (eq.(9)) | +| Point | Definition | +| ------------------------- | ----------------------------------------------------------------------------------------------- | +| ${\sf cc\_sp}_{i,j}$ | The $j$th **challenge chain signage point** in the $i$th slot (eq.(6)) | +| ${\sf rc\_sp}_{i,j}$ | The $j$th **reward chain signage point** in the $i$th slot (eq.(9)) | | ${\sf cc\_sp}(\beta)$ | he ${\sf cc\_sp}_{i,j}$ used as challenge to compute the PoSpace $\sigma$ in block $\beta$ | -| ${\sf rc\_sp}(\beta)$ | The ${\sf rc\_sp}_{i,j}$ whose signature $\mu_{{\sf rc\_sp}}$ is in $\beta$ | -| ${\sf rc\_ip}(\beta)$ | The infusion point of $\beta$ into ${\cal RC}$ (eq.(10) | +| ${\sf rc\_sp}(\beta)$ | The ${\sf rc\_sp}_{i,j}$ whose signature $\mu_{{\sf rc\_sp}}$ is in $\beta$ | +| ${\sf rc\_ip}(\beta)$ | The infusion point of $\beta$ into ${\cal RC}$ (eq.(10) | The _signage point interval_ is the number of VDF steps between signage points, for the $i$th slot it's $$ -{\sf spi}_i \stackrel{\scriptsize \sf def}{=}T_i/64 -$$ +{\sf spi}_i \stackrel{\scriptsize \sf def}{=}T_i/64 $$ so e.g., the depth of the $j$th signage point in the $i$th slot is $\mathsf{rc\_sp}_{i,j}.\mathsf{d} = \mathsf{cc\_sp}_{i,j}.\mathsf{d} = j \cdot \mathsf{spi}_i$. A block in the $i$th slot will be infused 3 to 4 signage point intervals past its signage point. -$$ -3\cdot {\sf spi}_i\ <\ -{\sf rc\_ip}(\beta_T).{\sf d}\ -\ {\sf rc\_sp}(\beta_T).{\sf d}\ < \ 4\cdot {\sf spi}_i -$$ +$$ 3\cdot {\sf spi}_i\ <\ +{\sf rc\_ip}(\beta_T).{\sf d}\ -\ {\sf rc\_sp}(\beta_T).{\sf d}\ < \ 4\cdot {\sf spi}_i $$ The first signage point in a slot is the last signage point after infusion $$ -{\sf rc\_sp}_{i+1,0}={\sf rc\_sp}_{i,\tau_i\cdot 64}^+ -$$ +{\sf rc\_sp}_{i+1,0}={\sf rc\_sp}_{i,\tau_i\cdot 64}^+ $$ The $i$th slot starts at total depth $$ -{\sf rc\_sp}_{i,0}.{\sf D}=\sum_{j=1}^{i-1}T_j\cdot \kappa_j -$$ +{\sf rc\_sp}_{i,0}.{\sf D}=\sum_{j=1}^{i-1}T_j\cdot \kappa_j $$ ## 5.2 The Challenge Chain The challenge chain ${\cal CC}$ is a VDF chain whose data and VDF values we'll denote as $$ -{\cal CC}={\sf ic}_0, \tau^{{\cal CC}}_1,{\sf ic}_1,\tau^{\cal CC}_2,{\sf ic}_2,\ldots -$$ +{\cal CC}={\sf ic}_0, \tau^{{\cal CC}}_1,{\sf ic}_1,\tau^{\cal CC}_2,{\sf ic}_2,\ldots $$ Here $\tau^{\cal CC}_i$ is the VDF computation for the $i$th slot. Usually its number of VDF steps is the current time parameter $T_i$ (and should take 10 minutes to compute), but in exceptional cases it can be an integer multiple $\kappa_i\in\mathbb{N}$ of that as we enforce a 16 block minimum per slot -$$ -\tau^{\cal CC}_i.{\sf t} = \kappa_i\cdot T_i \qquad\textrm{typically $\kappa_i=1$} -$$ +$$ \tau^{\cal CC}_i.{\sf t} = \kappa_i\cdot T_i \qquad\textrm{typically $\kappa_i=1$} $$ The value ${\sf ic}_i$ infused at the beginning of slot $i+1$ depends on the first block in slot $i$, we'll explain how exactly in §5.5. As the VDF $\tau^{\cal CC}_i$ of the $i$th slot is computed by a time lord, they release equidistant points of this computation called the _challenge chain signage points_, one every ${\sf spi}_i=T_i/64$ VDF steps or around $9.375=600/64$ seconds $$ -{\sf cc\_sp}_{i,0},{\sf cc\_sp}_{i,1},\ldots,{\sf cc\_sp}_{i,\tau_i\cdot 64}\quad\textrm{where}\quad {\sf cc\_sp}_{i,j}\stackrel{\scriptsize \sf def}{=}\tau^{\cal CC}_i[j\cdot {\sf spi}_i] -$$ +{\sf cc\_sp}_{i,0},{\sf cc\_sp}_{i,1},\ldots,{\sf cc\_sp}_{i,\tau_i\cdot 64}\quad\textrm{where}\quad {\sf cc\_sp}_{i,j}\stackrel{\scriptsize \sf def}{=}\tau^{\cal CC}_i[j\cdot {\sf spi}_i] $$
eq.(6)
@@ -115,21 +106,17 @@ The reward chain ${\cal RC}$ is a VDF chain that the time lords evaluate in para Whenever a farmer receives new signage points ${\sf cc\_sp}_{i,j},{\sf rc\_sp}_{i,j}$ they first check whether this points lie on a heaviest chain (cf. the discussion in §1.5) and their VDF proofs verify. If the this is the case, the farmer checks they can create a winning PoSpace proof. This process will, for a subset of the plots, produce a PoSpace $\sigma$ and some additional value $\sigma.{\sf required\_iterations}$. Whether this PoSpace is a winning proof is now determined by the time parameter $T_i$ as -$$ -\textrm{winning condition : } \sigma.{\sf required\_iterations} < {\sf spi}_i\quad (=T_i/64) -$$ +$$ \textrm{winning condition : } \sigma.{\sf required\_iterations} < {\sf spi}_i\quad (=T_i/64) $$
eq.(7)
:::tip Design Choice 2: Why 32 Blocks in Expectation and not Exactly? -With our winning condition we have 32 blocks per slot _in expectation_ depending on a challenge. We could have used a different design to enforce _exactly_ 32 challenges, but then it would be impossible to achieve our Objective 1.(c), which asks that whether a plot wins must depend solely on the challenge. +With our winning condition we have 32 blocks per slot _in expectation_ depending on a challenge. We could have used a different design to enforce _exactly_ 32 challenges, but then it would be impossible to achieve our Objective 1.(c), which asks that whether a plot wins must depend solely on the challenge. ::: We could have used a different design to enforce _exactly_ 32 challenges, but then it would be impossible to achieve our Objective 1.(c), which asks that whether a plot wins must depend solely on the challenge. ::: If a farmer has a winning PoSpace $\sigma$ they can produce a block $\beta=(\beta_T,\beta_F)$ which contains the foliage block $\beta_F$ and the trunk block $\beta_T$. The actual $\textsf{Chia}$ blocks are more sophisticated than our description below, but in this writeup we focus on the entries which are absolutely necessary for functionality and security of the chain and ignore entries which are there for efficiency like weight proofs for light clients or pooling. They key entries in a valid trunk block -$$ -\beta_T=(\sigma,\mu_{{{\sf rc\_sp}}}) -$$ +$$ \beta_T=(\sigma,\mu_{{{\sf rc\_sp}}}) $$ are @@ -142,22 +129,19 @@ $\mu_{\sf rc\_sp}\gets {{\sf Sig.sign}}(S.sk,{\sf rc\_sp}_{i,j})$, a signature u The reward chain ${\cal RC}$ is a VDF chain that time lords compute in parallel to ${\cal CC}$. Like ${\cal CC}$, ${\cal RC}$ can be spilt in a sequence of slots. $$ -{\cal RC}={\cal RC}_1,{\cal RC}_2,\ldots -$$ +{\cal RC}={\cal RC}_1,{\cal RC}_2,\ldots $$ While in ${\cal CC}$ the $i$th slot just contains a VDF $\tau^{\cal CC}_i$ and the value ${\sf ic}_i$ infused at the end, each slot ${\cal RC}_i$ of the ${\cal RC}$ chain $$ -{\cal RC}_i=\tau^{\cal RC}_{i,1},\beta_1,\tau^{\cal RC}_{i,2},\beta_2\ldots, \beta_{b_i} \tau^{\cal RC}_{i,b_i+1},({\sf ic}_i,\tau^{\cal CC}_{i}.{\sf y}) -$$ +{\cal RC}_i=\tau^{\cal RC}_{i,1},\beta_1,\tau^{\cal RC}_{i,2},\beta_2\ldots, \beta_{b_i} \tau^{\cal RC}_{i,b_i+1},({\sf ic}_i,\tau^{\cal CC}_{i}.{\sf y}) $$
eq.(8)
is a VDF chain with typically around $33$ infused values: around 32 blocks $b_i$ and at the end of the slot also the ${\cal CC}$ and ${\sf i}{\cal CC}$ points at the same depth. The ${\cal RC}$ signage points are $$ -{\sf rc\_sp}_{i,j}\stackrel{\scriptsize \sf def}{=}{\cal RC}_i[j\cdot {\sf spi}_i] -$$ +{\sf rc\_sp}_{i,j}\stackrel{\scriptsize \sf def}{=}{\cal RC}_i[j\cdot {\sf spi}_i] $$
eq.(9)
@@ -180,28 +164,21 @@ Recall that the challenge chain ${\cal CC}$ is used to create PoSpace challenges Concretely, the infused challenge of the $i$th slot is the output of a VDF computation $$ -{\sf ic}_i\stackrel{\scriptsize \sf def}{=}\tau.{\sf y}\qquad \tau={\sf VDF.solve}(x,t) -$$ +{\sf ic}_i\stackrel{\scriptsize \sf def}{=}\tau.{\sf y}\qquad \tau={\sf VDF.solve}(x,t) $$ on some challenge $x$ and time $t$ which are defined as follows. Let $\beta_T=(\sigma,\mu_{{{\sf rc\_sp}}})$ be the first trunk block infused into the $i$th slot ${\cal RC}_i$ past the 3rd signage point, using notion as in eq.(10) -$$ -\beta_T=\beta_j \textrm{ where }j=\min\{k\ :\ \beta_k.{\sf d}>3\cdot {\sf spi}\} -$$ +$$ \beta_T=\beta_j \textrm{ where }j=\min\{k\ :\ \beta_k.{\sf d}>3\cdot {\sf spi}\} $$ now the challenge $x$ is derived from the PoSpace in this block and the value of ${\cal CC}$ at the depth of its infusion point -$$ -\quad x\gets {\sf VDF.sample}(\sigma,{\cal CC}[{\sf rc\_ip}(\beta_T).{\sf D}].{\sf y}) -$$ +$$ \quad x\gets {\sf VDF.sample}(\sigma,{\cal CC}[{\sf rc\_ip}(\beta_T).{\sf D}].{\sf y}) $$ the number of steps $t$ is the the remaining number of VDF steps in the slot, so the value ${\sf ic}_i$ will be available at the end of the slot when it's required, but not earlier -$$ -t={\sf cc\_ip}_{i,0}.{\sf D}- {\sf rc\_ip}(\beta).{\sf D} -$$ +$$ t={\sf cc\_ip}_{i,0}.{\sf D}- {\sf rc\_ip}(\beta).{\sf D} $$ :::danger Security Notice 1: Why iCC depends only on σ We only use $\sigma$, not the entire trunk block $\beta_T=(\sigma,\mu_{{{\sf rc\_sp}}})$, to compute the infused challenge ${\sf ic}_i$. This is crucial to ensure that the challenges depend only on a single challenge per slot. Had we infused the entire $\beta_T$ (as we do into ${\cal RC}$), the challenges would depend on all blocks (as $\mu_{{\sf rc\_sp}}$ depends on ${\cal RC}$ which infuses all blocks) and we would not get security against double dipping. @@ -229,15 +206,11 @@ To limit the impact of double-dipping we use correlated randomness [ -Your Linux installation may not come with Python's development tools installed by default. To be sure that these tools are installed, run: +Your Linux installation may not come with Python's development tools installed by default. Your Linux installation may not come with Python's development tools installed by default. To be sure that these tools are installed, run: ```bash sudo apt-get install -y build-essential python3-dev @@ -145,6 +145,31 @@ pip install chia-dev-tools --no-deps Install pytest: +```bash +pip install pytest +``` ./venv/bin/activate +``` + +Install the prerequisites: + +```bash +python3 -m pip install --upgrade pip setuptools wheel +``` + +Install the tool: + +```bash +pip install . +``` + +Install chia dev tools: + +```bash +pip install chia-dev-tools --no-deps +``` + +Install pytest: + ```bash pip install pytest ``` @@ -201,6 +226,23 @@ pip install pytest :::note You might receive an error such as ERROR: Failed building wheel for CAT-admin-tool. This is likely safe to ignore. As long as you can run cats --help without errors, the tool has been installed properly. ::: +``` + +Install Chia dev tools: + +```bash +pip install chia-dev-tools --no-deps +``` + +Install pytest: + +```bash +pip install pytest +``` + +:::note +You might receive an error such as ERROR: Failed building wheel for CAT-admin-tool. This is likely safe to ignore. As long as you can run cats --help without errors, the tool has been installed properly. +::: @@ -225,7 +267,7 @@ To get started, you will create a single-issuance CAT. This is the default way t :::note -A TAIL is a Chialisp program that defines the rules for issuing and melting tokens. Learn more about the [Token and Asset Issuance Limitations program](https://chialisp.com/cats/#tail). +A TAIL is a Chialisp program that defines the rules for issuing and melting tokens. Learn more about the [Token and Asset Issuance Limitations program](https://chialisp.com/cats/#tail). Learn more about the [Token and Asset Issuance Limitations program](https://chialisp.com/cats/#tail). ::: @@ -233,7 +275,7 @@ A CAT with a single-issuance TAIL will be useful for anyone who wants to create First, figure out how many tokens you want to issue. Because creating a single token takes 1,000 mojos, you will multiply your supply by 1,000 to figure out how much TXCH (or XCH on mainnet) is needed. For example, if you want to issue 1 million tokens, you'll need 1 billion mojos (1/1000 of a TXCH/XCH). -Take note of your _Receive Address_ in the Chia GUI. (Alternatively, run `chia wallet get_address` from a terminal window.) You'll need this address for the next step. +Take note of your _Receive Address_ in the Chia GUI. (Alternatively, run `chia wallet get_address` from a terminal window.) You'll need this address for the next step. (Alternatively, run `chia wallet get_address` from a terminal window.) You'll need this address for the next step. After confirming you are within the admin tool directory, run: @@ -281,7 +323,7 @@ First, figure out how many tokens you want to issue. Because creating a single t Just as with the Single Issuance CAT, we recommend that you include a fee with your transaction. This fee will ensure that your transaction is processed in front of any dust in the mempool. Whether you're running on testnet or mainnet, the recommended fee amount is 100 million mojos (`-m 100000000`). Even though you will run the `cats` command multiple times, the fee will only be applied once, when the transaction is pushed to the network. ::: -Run `chia wallet get_address` from a terminal window to get a new receive address. You will use this address shortly. +Run `chia wallet get_address` from a terminal window to get a new receive address. You will use this address shortly. You will use this address shortly. Run `chia keys show`. Take note of your **fingerprint** and **master public key**. @@ -373,7 +415,7 @@ When you are ready to issue your CAT to mainnet, the first step is to switch to chia configure -t false ``` -The second step is to generate a new key pair and store the mnemonic in a secure manner. You can generate your key by clicking `Add Wallet` and `Create New` from the `Wallet Keys` login screen of the GUI. This will work in the same manner as earlier for our testnet CAT. +The second step is to generate a new key pair and store the mnemonic in a secure manner. The second step is to generate a new key pair and store the mnemonic in a secure manner. You can generate your key by clicking `Add Wallet` and `Create New` from the `Wallet Keys` login screen of the GUI. This will work in the same manner as earlier for our testnet CAT. This will work in the same manner as earlier for our testnet CAT. :::danger We recommend the new keypair being used exclusively for the CAT ownership. @@ -397,6 +439,6 @@ Finally, you can go through the same process to create a CAT now using real XCH Congratulations! You've created your first CAT. What now? -Well, hopefully you can share your CAT with the world and get some traction. In the meantime, you can learn more about the [Single Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/genesis_by_coin_id.clsp) and [Multi Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/delegated_tail.clsp). +Well, hopefully you can share your CAT with the world and get some traction. Well, hopefully you can share your CAT with the world and get some traction. In the meantime, you can learn more about the [Single Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/genesis_by_coin_id.clsp) and [Multi Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/delegated_tail.clsp). This guide was for fungible tokens. Now you can learn about [non-fungible tokens](/guides/nft-intro). diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md index a456565c45..9a37338603 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md @@ -31,15 +31,15 @@ Now that you have a CSV file containing the necessary information, you can run t 1. Open a new terminal window and run the following to clone the CAT Admin Tool repository, using the `main` branch: - ```bash - git clone https://github.com/Chia-Network/CAT-admin-tool.git -b main - ``` +```bash +git clone https://github.com/Chia-Network/CAT-admin-tool.git -b main +``` 2. Change to the cloned repository: - ```bash - cd CAT-admin-tool - ``` +```bash +cd CAT-admin-tool +``` 3. Create a new virtual environment and then activate it: @@ -60,22 +60,24 @@ python -m venv venv - -```bash + + ```bash python3 -m venv venv . ./venv/bin/activate -``` - +``` ./venv/bin/activate + ``` + - -```bash + + ```bash python3 -m venv venv . ./venv/bin/activate -``` - +``` ./venv/bin/activate + ``` + - + 4. Install the latest versions of `pip`, `setuptools` and `wheel`: @@ -95,37 +97,36 @@ python -m pip install --upgrade pip setuptools wheel - -```bash + + ```bash python3 -m pip install --upgrade pip setuptools wheel ``` - + - -```bash + + ```bash python3 -m pip install --upgrade pip setuptools wheel ``` - + - + 5. Install the CAT Admin Tool: - ```bash - pip install . +```bash +pip install . +pip install . pip install chia-dev-tools --no-deps pip install pytest - ``` +``` - :::note You can safely ignore the following errors: +:::note You can safely ignore the following errors: - ``` - ERROR: Failed building wheel for CAT-admin-tool +``` +ERROR: Failed building wheel for CAT-admin-tool ERROR: pip's dependency resolver... - ``` - - ::: +``` :::tip Python 3.9+ may be required on macOS @@ -133,12 +134,12 @@ Python 3.9+ may be required on macOS 6. The CAT Admin Tool should now be installed and configured properly. To test it, run: - ```bash - cats --help +```bash +cats --help cdv --help - ``` +``` - You should get a usage statement for each command. At this point, you're ready to create your new CAT2 coins. +You should get a usage statement for each command. At this point, you're ready to create your new CAT2 coins. ## Secure the Bag (Single Issuance) {#secure-single} @@ -151,10 +152,10 @@ This section will show you how to create a tree of CAT2 coins that are identical If you are unsure whether your CAT used a single- or multi-issuance TAIL, step 1 will show you how to view the TAIL that was used to create it. 1. Figure out the total number of XCH mojos that were issued for your CAT1. - - Navigate to [taildatabase.com](https://www.taildatabase.com). - - Search for your CAT. We'll use Spacebucks for this example. - - You'll see _Supply_ (and a number) under the title on the right side of your screen. The number indicates the number of tokens issued. However, you need to multiply this number by 1,000 in order to calculate the number of XCH mojos used for the issuance. For example, Spacebucks had an issuance of 1 billion (1,000,000,000) tokens, which is equivalent to 1 trillion (1,000,000,000,000) XCH mojos. +- Navigate to [taildatabase.com](https://www.taildatabase.com). +- Search for your CAT. We'll use Spacebucks for this example. +- You'll see _Supply_ (and a number) under the title on the right side of your screen. The number indicates the number of tokens issued. However, you need to multiply this number by 1,000 in order to calculate the number of XCH mojos used for the issuance. For example, Spacebucks had an issuance of 1 billion (1,000,000,000) tokens, which is equivalent to 1 trillion (1,000,000,000,000) XCH mojos. - Click the _Chialisp_ button. This will show you the TAIL that was used for issuance. If it was a single-issuance CAT, it likely used `genesis_by_coin_id`. If you are unsure, compare the TAIL shown with the [TAIL in GitHub](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/genesis_by_coin_id.clvm). Take note of this TAIL as you will need to input its hex version in a subsequent step (if you used one of our reference TAILs, then you already have a copy of this file). 2. Sync a Chia wallet that has at least as many XCH mojos as the original issuance. @@ -165,25 +166,25 @@ If you are unsure whether your CAT used a single- or multi-issuance TAIL, step 1 - You can run either the light wallet or a full node. - You are recommended to have enough mojos to cover transaction fees for the reissuance. The recommended amount is five hundred thousand (500,000) mojos per coin to be reissued. - You are **required** to have a single coin that is large enough to cover the entire reissuance. Even if your XCH balance is sufficient, it may be separated into multiple small coins. The easiest way to ensure that you have a sufficiently large coin is to send a transaction to yourself of at least the total value required. - ::: +::: 3. Use the CAT Admin Tool to select a coin that will be used for issuing the CAT2 tokens. - From a terminal window you'll need to run the `cats` command. The arguments needed for this command include: +From a terminal window you'll need to run the `cats` command. The arguments needed for this command include: - - `--tail` – The TAIL program that was originally used (usually this is `genesis_by_coin_id`), in hex file format. - - `--send-to` – Where to send the tokens when they are initially issued. This is a placeholder only – you can enter any XCH address here. The value is required, but it will be ignored. - - `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. - - `--as-bytes` – This tells the tool to output the spend bundle in bytes instead of JSON. - - `--select-coin` – This tells the tool to select a specific coin from your wallet. +- `--tail` – The TAIL program that was originally used (usually this is `genesis_by_coin_id`), in hex file format. +- `--send-to` – Where to send the tokens when they are initially issued. This is a placeholder only – you can enter any XCH address here. The value is required, but it will be ignored. +- `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. +- `--as-bytes` – This tells the tool to output the spend bundle in bytes instead of JSON. +- `--select-coin` – This tells the tool to select a specific coin from your wallet. - The command to run is: +The command to run is: - ```bash - cats --tail --send-to
--amount --as-bytes --select-coin - ``` +```bash +cats --tail --send-to
--amount --as-bytes --select-coin +``` - Here's an example of the command to reissue Spacebucks: +Here's an example of the command to reissue Spacebucks: - -```bash -cats --tail ./reference_tails/genesis_by_coin_id.clsp.hex --send-to xch1rh6punh4fy70y80ef4g89c9hqvm54dtl0fvyc4ejdccp3y6p04fqn5x8x8 --amount 1000000000000 --as-bytes --select-coin + + ```bash +cats --tail ./reference_tails/delegated_tail.clsp.hex --curry 0x8a7afe10d00899b94cf0d407b85e1b9fca21868bcf158563fe9432b60e36db7136055186221fbd27ecc7fc0d5b99ef1b --send-to xch1rd7hejemt57amqtxq8azqg90hgxyhd9shwyjuppq5ez2jn4rlznscn4efy --amount 6000000000 --as-bytes --solution "(a (q 2 (i 47 (q 8) (q 2 (i (= 45 2) () (q 8)) 1)) 1) (c (q . 0x11038a7e107cb7e17a503ba201d94166018deecd777314e4697c5269d9f37fb6) 1))" --signature b75390ee21b001b7a721f719ff045e3dc2a1072ab0824a8e75c881398db0fbed8fde5c62bbdfe629dce5da3d77834559016acd6d403f9b90d3102da2e9452461457514088af0cabe0b8a8493fc9c09d1785f1322abc8958ecf7907eba0e0abcc ``` - + The last line of the output will be something like: @@ -226,18 +227,18 @@ This is the Coin ID of the coin that you will use for reissuance. Keep this valu 4. Obtain the target puzzle hash by running the "secure_the_bag" command. The important arguments here are: - - `--tail` – The TAIL program that was originally used (usually this is `genesis_by_coin_id`), in hex file format. - - `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. - - `--secure-the-bag-targets-path` – The full path to the CSV file that contains the snapshot of this CAT. - - `--curry` – The value of `Name:` from the above output. Note that you need to prepend `0x` to this argument, so for the above example, this value would start with `0x8f4`. +- `--tail` – The TAIL program that was originally used (usually this is `genesis_by_coin_id`), in hex file format. +- `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. +- `--secure-the-bag-targets-path` – The full path to the CSV file that contains the snapshot of this CAT. +- `--curry` – The value of `Name:` from the above output. Note that you need to prepend `0x` to this argument, so for the above example, this value would start with `0x8f4`. - The command to run is: +The command to run is: - ```bash - secure_the_bag --tail --amount --secure-the-bag-targets-path --prefix xch --curry - ``` +```bash +secure_the_bag --tail --amount --secure-the-bag-targets-path --prefix xch --curry +``` - Here's an example of the command to secure the bag for Spacebucks: +Here's an example of the command to secure the bag for Spacebucks: - + The command will create a tree of coins. This could take a long time, depending on how many coins need to be created. While it's in progress, it will output the percent complete. After it is finished, it will output the puzzle hash and address of the new coin to be created. @@ -283,15 +284,15 @@ You'll need both of these values later. 5. Push the transaction to the network. This will actually create the coin tree (_Secure the Bag_). The arguments are the same as above, with one exception: - `--send-to` – The XCH address from the "Secure the bag root address:" of the above output +`--send-to` – The XCH address from the "Secure the bag root address:" of the above output - The command to run is: +The command to run is: - ```bash - cats --tail --send-to --amount --as-bytes --curry <0x Coin ID> - ``` +```bash +cats --tail --send-to --amount --as-bytes --curry <0x Coin ID> +``` - For this example, the command looks like this: +For this example, the command looks like this: - + You will need to confirm that you want to push the transaction, then you will receive the `Asset ID` and `Eve Coin ID`. For this example, the following was the result: @@ -351,10 +352,10 @@ You need to use the same public/private key pair to sign the CAT2 issuance as yo 1. Figure out the total number of XCH mojos that were issued for your CAT1. - - Navigate to [taildatabase.com](https://www.taildatabase.com). - - Search for your CAT. - - You'll see _Supply_ (and a number) under the title on the right side of your screen. The number indicates the number of tokens issued. However, you need to multiply this number by 1,000 in order to calculate the number of XCH mojos used for the issuance. In this example, we'll use an issuance of 6 million (6,000,000) tokens, which is equivalent to 6 billion (6,000,000,000) XCH mojos. - - Click the _Chialisp_ button. This will show you the TAIL that was used for issuance. If it was a multi-issuance CAT, it likely used `delegated_tail`. If you are unsure, compare the TAIL shown with the [TAIL in GitHub](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/delegated_tail.clvm). Take note of this TAIL as you will need to input its hex version in a subsequent step (if you used one of our reference TAILs, then you already have a copy of this file). +- Navigate to [taildatabase.com](https://www.taildatabase.com). +- Search for your CAT. +- You'll see _Supply_ (and a number) under the title on the right side of your screen. The number indicates the number of tokens issued. However, you need to multiply this number by 1,000 in order to calculate the number of XCH mojos used for the issuance. In this example, we'll use an issuance of 6 million (6,000,000) tokens, which is equivalent to 6 billion (6,000,000,000) XCH mojos. +- Click the _Chialisp_ button. This will show you the TAIL that was used for issuance. If it was a multi-issuance CAT, it likely used `delegated_tail`. If you are unsure, compare the TAIL shown with the [TAIL in GitHub](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/delegated_tail.clvm). Take note of this TAIL as you will need to input its hex version in a subsequent step (if you used one of our reference TAILs, then you already have a copy of this file). 2. Sync a Chia wallet that has at least as many XCH mojos as the original issuance. @@ -364,25 +365,25 @@ You need to use the same public/private key pair to sign the CAT2 issuance as yo - You can run either the light wallet or a full node. - You are recommended to have enough mojos to cover transaction fees for the reissuance. The recommended amount is five hundred thousand (500,000) mojos per coin to be reissued. - You are **required** to have a single coin that is large enough to cover the entire reissuance. Even if your XCH balance is sufficient, it may be separated into multiple small coins. The easiest way to ensure that you have a sufficiently large coin is to send a transaction to yourself of at least the total value required. - ::: +::: 3. Use the CAT Admin Tool to select a coin that will be used for issuing the CAT2 tokens. - From a terminal window you'll need to run the `cats` command. The arguments needed for this command include: +From a terminal window you'll need to run the `cats` command. The arguments needed for this command include: - - `--tail` – The TAIL program that was originally used (usually this is `delegated_tail`), in hex file format. - - `--send-to` – Where to send the tokens when they are initially issued. This is a placeholder only – you can enter any XCH address here. The value is required, but it will be ignored. - - `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. - - `--as-bytes` – This tells the tool to output the spend bundle in bytes instead of JSON. - - `--select-coin` – This tells the tool to select a specific coin from your wallet. +- `--tail` – The TAIL program that was originally used (usually this is `delegated_tail`), in hex file format. +- `--send-to` – Where to send the tokens when they are initially issued. This is a placeholder only – you can enter any XCH address here. The value is required, but it will be ignored. +- `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. +- `--as-bytes` – This tells the tool to output the spend bundle in bytes instead of JSON. +- `--select-coin` – This tells the tool to select a specific coin from your wallet. - The command to run is: +The command to run is: - ```bash - cats --tail --send-to
--amount --as-bytes --select-coin - ``` +```bash +cats --tail --send-to
--amount --as-bytes --select-coin +``` - Here's an example of the command: +Here's an example of the command: - + The last line of the output will be something like: @@ -425,18 +426,18 @@ This is the Coin ID of the coin that you will use for reissuance. Keep this valu 4. Obtain the target puzzle hash by running the "secure_the_bag" command. The important arguments here are: - - `--tail` – The TAIL program that was originally used (usually this is `delegated_tail`), in hex file format. - - `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. - - `--secure-the-bag-targets-path` – The full path to the CSV file that contains the snapshot of this CAT. - - `--curry` – The value of `Name:` from the above output. Note that you need to prepend `0x` to this argument, so for the above example, this value would start with `0x110`. +- `--tail` – The TAIL program that was originally used (usually this is `delegated_tail`), in hex file format. +- `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. +- `--secure-the-bag-targets-path` – The full path to the CSV file that contains the snapshot of this CAT. +- `--curry` – The value of `Name:` from the above output. Note that you need to prepend `0x` to this argument, so for the above example, this value would start with `0x110`. - The command to run is: +The command to run is: - ```bash - secure_the_bag --tail --amount --secure-the-bag-targets-path --prefix xch --curry - ``` +```bash +secure_the_bag --tail --amount --secure-the-bag-targets-path --prefix xch --curry +``` - Here's an example of the command to secure the bag: +Here's an example of the command to secure the bag: - + The command will create a tree of coins. This could take a long time, depending on how many coins need to be created. While it's in progress, it will output the percent complete. After it is finished, it will output the puzzle hash and address of the new coin to be created. @@ -482,13 +483,13 @@ You should now have obtained the `Secure the bag root puzzle hash` and the `Secu 5. Using the coin ID obtained from the `cats` command above, curry the ID into the `genesis_by_coin_id` puzzle. - The command to run is: +The command to run is: - ```bash - cdv clsp curry -a - ``` +```bash +cdv clsp curry -a +``` - In this example, the command will be: +In this example, the command will be: - + The output will be a new CLVM puzzle: @@ -560,7 +561,7 @@ cdv clsp curry ./reference_tails/genesis_by_coin_id.clsp.hex -a 0x11038a7e107cb7 ``` - + The output will be the treehash of the puzzle you calculated in the previous step: @@ -570,46 +571,46 @@ The output will be the treehash of the puzzle you calculated in the previous ste 7. Sign the treehash that you just calculated. This will effectively sign the puzzle containing the coin you selected. - The command to run is: +The command to run is: - ```bash - chia keys sign -d -f -t m -b - ``` +```bash +chia keys sign -d -f -t m -b +``` - Where `` is the fingerprint of the wallet that holds the coin you previously selected. This fingerprint can be obtained by running `chia keys show`. +Where `` is the fingerprint of the wallet that holds the coin you previously selected. This fingerprint can be obtained by running `chia keys show`. - For this example, the command is: +For this example, the command is: - ```bash - chia keys sign -d 3a56fa8cdf70dfd0e894af58359d72cb04658a1b0628a4ffe0dcc02099c9863b -f 1131363750 -t m -b - ``` +```bash +chia keys sign -d 3a56fa8cdf70dfd0e894af58359d72cb04658a1b0628a4ffe0dcc02099c9863b -f 1131363750 -t m -b +``` - The output will be the public key used for signing, as well as the signature obtained: +The output will be the public key used for signing, as well as the signature obtained: - ``` - Public key: 8a7afe10d00899b94cf0d407b85e1b9fca21868bcf158563fe9432b60e36db7136055186221fbd27ecc7fc0d5b99ef1b +``` +Public key: 8a7afe10d00899b94cf0d407b85e1b9fca21868bcf158563fe9432b60e36db7136055186221fbd27ecc7fc0d5b99ef1b Signature: b75390ee21b001b7a721f719ff045e3dc2a1072ab0824a8e75c881398db0fbed8fde5c62bbdfe629dce5da3d77834559016acd6d403f9b90d3102da2e9452461457514088af0cabe0b8a8493fc9c09d1785f1322abc8958ecf7907eba0e0abcc - ``` +``` 8. The final step is to create the coin using the `secure the bag root address` as the target address. - The command to run is: +The command to run is: - ``` - cats --tail --curry --send-to --amount --as-bytes --solution "" --signature - ``` +``` +cats --tail --curry --send-to --amount --as-bytes --solution "" --signature +``` - The arguments needed are: +The arguments needed are: - - `--tail` – The TAIL program that was originally used (usually this is `delegated_tail`), in hex file format. - - `--curry` – The public key obtained in the previous step. Be sure to prefix it with `0x`. - - `--send-to` – The `secure the bag root address`, obtained from in a previous step. - - `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. - - `--as-bytes` – Output the spend bundle in bytes (don't change this). - - `--solution` – The output of the `curry` command from a previous step (in quotes). - - `--signature` – The signature obtained from the previous step. +- `--tail` – The TAIL program that was originally used (usually this is `delegated_tail`), in hex file format. +- `--curry` – The public key obtained in the previous step. Be sure to prefix it with `0x`. +- `--send-to` – The `secure the bag root address`, obtained from in a previous step. +- `--amount` – The total number of mojos for this issuance. You need to have this many mojos in your wallet. This number must match the actual number of mojos that were originally issued. +- `--as-bytes` – Output the spend bundle in bytes (don't change this). +- `--solution` – The output of the `curry` command from a previous step (in quotes). +- `--signature` – The signature obtained from the previous step. - For this example, the command to execute is: +For this example, the command to execute is: @@ -640,7 +642,7 @@ cats --tail ./reference_tails/delegated_tail.clsp.hex --curry 0x8a7afe10d00899b9 ``` - + The output of this command will contain the Asset ID and Eve Coin ID for your issuance: @@ -710,7 +712,7 @@ unwind_the_bag --eve-coin-id 9fe3e95308949cb9c49333f829922dc7118cd3e2fdf365cde66 ``` - + This command could take a long time to finish running. Afterward, you will have an exact copy of your CAT1 issuance, but in CAT2 form. @@ -726,50 +728,50 @@ At this point, you can navigate to [taildatabase.com](https://www.taildatabase.c 1. We used Spacebucks in the single-issuance example, so we'll obtain the puzzle hash of a wallet that contains some CAT1 Spacebucks. First, run: - ```bash - chia keys show - ``` +```bash +chia keys show +``` - This will show the `First wallet address` of the key pair that contains Spacebucks: +This will show the `First wallet address` of the key pair that contains Spacebucks: - ``` - First wallet address: xch1qzz5xrd05698f2n2tt4qm500kys6p4w79ph7s2xrlau3drfugl3qqh9j4l - ``` +``` +First wallet address: xch1qzz5xrd05698f2n2tt4qm500kys6p4w79ph7s2xrlau3drfugl3qqh9j4l +``` 2. Use the `cdv decode` command to obtain the puzzle hash that corresponds to this wallet address: - ```bash - cdv decode xch1qzz5xrd05698f2n2tt4qm500kys6p4w79ph7s2xrlau3drfugl3qqh9j4l - ``` +```bash +cdv decode xch1qzz5xrd05698f2n2tt4qm500kys6p4w79ph7s2xrlau3drfugl3qqh9j4l +``` - Which outputs: +Which outputs: - ``` - 0085430dafa68a74aa6a5aea0dd1efb121a0d5de286fe828c3ff79168d3c47e2 - ``` +``` +0085430dafa68a74aa6a5aea0dd1efb121a0d5de286fe828c3ff79168d3c47e2 +``` 3. If you want to verify that the puzzle hash is actually due to receive some tokens, you can check the CSV file. In this case, puzzle hash `0085...` should receive 42 thousand (42,000) barfs. 4. Run the `unwind_the_bag` command to send the appropriate amount to that puzzle hash. Be sure to run this command from the wallet that has the appropriate funds in it. - The important values for this command are: +The important values for this command are: - - `--eve-coin-id` – Obtained from the final "secure the bag" command above. - - `--tail-hash` – The `Asset ID:` from the final "secure the bag" command above. - - `--secure-the-bag-targets-path` – The full path to the CSV file that contains the snapshot of this CAT. - - `--unwind-fee` – An optional blockchain fee in mojos, will be applied to each spend. - - `--wallet-id` – The ID of the wallet from which to unwind (typically `1`). - - `--unwind-target-puzzle-hash` – The puzzle hash obtained from the `cdv decode` command above. +- `--eve-coin-id` – Obtained from the final "secure the bag" command above. +- `--tail-hash` – The `Asset ID:` from the final "secure the bag" command above. +- `--secure-the-bag-targets-path` – The full path to the CSV file that contains the snapshot of this CAT. +- `--unwind-fee` – An optional blockchain fee in mojos, will be applied to each spend. +- `--wallet-id` – The ID of the wallet from which to unwind (typically `1`). +- `--unwind-target-puzzle-hash` – The puzzle hash obtained from the `cdv decode` command above. - The command to run is: +The command to run is: - ```bash - unwind_the_bag --eve-coin-id --tail-hash --secure-the-bag-targets-path --unwind-fee --wallet-id --unwind-target-puzzle-hash - ``` +```bash +unwind_the_bag --eve-coin-id --tail-hash --secure-the-bag-targets-path --unwind-fee --wallet-id --unwind-target-puzzle-hash +``` - You may have noticed that this command is identical to [the command that unwinds the whole bag](#unwind), with the addition of the `--unwind-target-puzzle-hash` flag that ensures only coins are sent to a specific address. +You may have noticed that this command is identical to [the command that unwinds the whole bag](#unwind), with the addition of the `--unwind-target-puzzle-hash` flag that ensures only coins are sent to a specific address. - In this example, the command to unwind the bag is: +In this example, the command to unwind the bag is: - + This command could take a long time, depending on the total number of coins to unwind. You will need to verify the spend of each individual coin to unwind, and the command will monitor the blockchain for the coin(s) to be spent. The end result should be that the appropriate number of coins are sent to the puzzle hash, which you can then verify in your Chia wallet (assuming you control that wallet). :::note -Each puzzle hash in the bag can only receive one airdrop. When you later unwind the bag for each puzzle hash, any puzzle hashes that have already received an airdrop will be skipped. They will _not_ receive a second airdrop. +Each puzzle hash in the bag can only receive one airdrop. When you later unwind the bag for each puzzle hash, any puzzle hashes that have already received an airdrop will be skipped. They will _not_ receive a second airdrop. ::: When you later unwind the bag for each puzzle hash, any puzzle hashes that have already received an airdrop will be skipped. They will _not_ receive a second airdrop. ::: 5. The puzzle hashes from the CSV file are actually _inner_ puzzle hashes, so searching for them on chain using `cdv rpc coinrecords` is more complex than it normally would be. However, you can still verify that the bag was successfully unwound for that puzzle hash by searching for the hint: @@ -841,7 +843,7 @@ chia rpc full_node get_coin_records_by_hint '{"hint": " - + You should see matching coin_records for each entry in the CSV file, along with its corresponding value. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md index 13985c6cae..e6e2e341fa 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md @@ -49,7 +49,7 @@ values={[ :::caution Ensure that you replace `` and `` with the actual folders -::: +::: ```powershell Set-Alias -Name chia "C:\Users\\AppData\Local\chia-blockchain\app-\resources\app.asar.unpacked\daemon\chia.exe" @@ -64,12 +64,15 @@ Set-Alias -Name chia "C:\Users\\AppData\Local\chia-blockchain\app- +- If you previously installed Chia from a **binary build**, then ensure that the `chia` binary's directory is included in your `PATH`. + 1. If you previously installed Chia from a **binary build**, then ensure that the `chia` binary's directory is included in your `PATH`. 2. If you previously installed Chia **from source**, then navigate to the `chia-blockchain` directory and activate your virtual environment: ```bash . ./activate +``` ./activate ``` @@ -85,6 +88,7 @@ alias chia="/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon/c ```bash . ./activate +``` ./activate ``` @@ -111,11 +115,10 @@ alias chia="/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon/c 3. `START_HEIGHT` - The height of the blockchain to start creating the snapshot from (default: `0`). If you are attempting to obtain all records for your CAT, the recommended start height is `1146800`, which is just before CAT1 was introduced. 4. `TARGET_HEIGHT` - The height of the blockchain to end the snapshot (no default - must be set). The recommended height is `2311760`, which is the last block at which CAT1 is valid. -:::caution -Running this process with the recommended block heights could take over 40 hours to complete. You may wish to test it first by setting the `TARGET_HEIGHT` to `1146900`. This will pull data from only 100 blocks, which should only take a few seconds. + :::caution Running this process with the recommended block heights could take over 40 hours to complete. You may wish to test it first by setting the `TARGET_HEIGHT` to `1146900`. This will pull data from only 100 blocks, which should only take a few seconds. ::: -In order to set these variables, you are recommended to put them into a file called `.env` at the root of the `CAT-addresses` project. The tool will automatically read the variables in this file. For example: + In order to set these variables, you are recommended to put them into a file called `.env` at the root of the `CAT-addresses` project. The tool will automatically read the variables in this file. For example: ` - a string to be prepended to the output file name - `` - the TAIL hash you obtained from taildatabase.com - `--coins` - an **optional** flag that will add information about individual coins to the output (which might be helpful for auditing purposes) - ::: +::: :::note -This command will not create any directories, so make sure `` already exists before running it. Otherwise, you will receive a `FileNotFoundError`. +This command will not create any directories, so make sure `` already exists before running it. Otherwise, you will receive a `FileNotFoundError`. ::: Otherwise, you will receive a `FileNotFoundError`. ::: ## Fix EOL Characters {#fix-eol} diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md index ce0f156592..8307fd3a2d 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md @@ -8,7 +8,7 @@ import TabItem from '@theme/TabItem'; ## Intro -Credential Restricted Chia Asset Tokens (CR-CATs) are CATs whose ownership is restricted to people or other entities who possess a required set of Verifiable Credentials (VCs). This guide will show you how to mint CR-CATs, as well as how to distribute them accordingly. +Credential Restricted Chia Asset Tokens (CR-CATs) are CATs whose ownership is restricted to people or other entities who possess a required set of Verifiable Credentials (VCs). This guide will show you how to mint CR-CATs, as well as how to distribute them accordingly. This guide will show you how to mint CR-CATs, as well as how to distribute them accordingly. For additional resources, see the following: @@ -19,16 +19,16 @@ For additional resources, see the following: :::warning -The commands in this guide are only examples. Be sure to replace the listed values with values from your local system. +The commands in this guide are only examples. The commands in this guide are only examples. Be sure to replace the listed values with values from your local system. -This guide was creating using testnet10. The example commands use a fee of 100 million mojos, which will be rather high for mainnet usage. If running on mainnet, be sure to adjust your fees accordingly. +This guide was creating using testnet11. This guide was creating using testnet10. The example commands use a fee of 100 million mojos, which will be rather high for mainnet usage. If running on mainnet, be sure to adjust your fees accordingly. If running on mainnet, be sure to adjust your fees accordingly. ::: ## Definitions - **Decentralized Identifier (DID)** -- An identifier that enables verifiable, decentralized digital identity -- **Verifiable Credential (VC)** -- Allows someone or something to prove that a subject belongs to a certain category or categories, such as being a US citizen. One type of VC is issued by a Know Your Customer (KYC) provider, who must perform this verification. +- **Verifiable Credential (VC)** -- Allows someone or something to prove that a subject belongs to a certain category or categories, such as being a US citizen. One type of VC is issued by a Know Your Customer (KYC) provider, who must perform this verification. One type of VC is issued by a Know Your Customer (KYC) provider, who must perform this verification. - **Chia Asset Tokens (CATs)** -- Fungible tokens on the Chia blockchain ## Setup @@ -39,24 +39,25 @@ In order to mint CR-CATs, you will need to have: - A synced Chia wallet, running version 2.0 or later (a full node is _not_ required) - At least one DID to be used as a trusted provider -- A sufficient amount of XCH or TXCH for the minting. As a reminder, each CAT consists of 1000 mojos. If you want to mint 1 billion CATs, you will need 1 trillion mojos (1 XCH) for the minting. +- A sufficient amount of XCH or TXCH for the minting. As a reminder, each CAT consists of 1000 mojos. A sufficient amount of XCH or TXCH for the minting. As a reminder, each CAT consists of 1000 mojos. If you want to mint 1 billion CATs, you will need 1 trillion mojos (1 XCH) for the minting. - Sufficient funds to cover blockchain fees, the amount of which depends on how busy the blockchain is at any moment We have faucets available if you don't have sufficient funds to get started: -- [testnet](https://testnet10-faucet.chia.net/) +- [testnet](https://testnet11-faucet.chia.net/) - [mainnet](https://faucet.chia.net/) :::warning important -It is possible to brick\* funds by sending them to an address without the appropriate credentials, as will be demonstrated later in this guide. You are therefore recommended to test minting CR-CATs on the testnet or on a simulator prior to minting them on mainnet. If you are unsure of how to configure your wallet to use the testnet, see our [guide](https://docs.chia.net/guides/chialisp-testnet-setup). +It is possible to brick\* funds by sending them to an address without the appropriate credentials, as will be demonstrated later in this guide. You are therefore recommended to test minting CR-CATs on the testnet or on a simulator prior to minting them on mainnet. You are recommended to test minting VCs on the testnet prior to minting them on mainnet. If you are unsure of how to configure your wallet to use the testnet, see our [guide](https://docs.chia.net/guides/chialisp-testnet-setup). \* Technically, the funds will remain recoverable, but this process will not be easy. ::: +::: ### DID and VC Setup -CR-CATs require at least one authorized provider that can issue VCs that are allowed to trade the CATs. This tutorial will use a DID as the authorized provider. +CR-CATs require at least one authorized provider that can issue VCs that are allowed to trade the CATs. This tutorial will use a DID as the authorized provider. This tutorial will use a DID as the authorized provider. :::info @@ -139,7 +140,7 @@ The VC is also viewable from the GUI: #### VC Holder Wallet -- Holds a VC with launcher ID `5b5389e77b7ec8e9ebd7d92136254418ca674e382031d29aaa6ab75b7822792b` and two proofs: `test_proof1` and `test_proof2`. This VC was provided by the Authorized Provider wallet. +- Holds a VC with launcher ID `5b5389e77b7ec8e9ebd7d92136254418ca674e382031d29aaa6ab75b7822792b` and two proofs: `test_proof1` and `test_proof2`. This VC was provided by the Authorized Provider wallet. This VC was provided by the Authorized Provider wallet. - Does not own a DID - This wallet will receive some CR-CATs from the Authorized Provider @@ -205,7 +206,7 @@ Chia Wallet: ### CAT Admin Tool -CR-CATS are issued from the CAT-admin-tool repository. Follow the instructions below to install it for your specific OS: +CR-CATS are issued from the CAT-admin-tool repository. Follow the instructions below to install it for your specific OS: Follow the instructions below to install it for your specific OS: @@ -300,7 +315,7 @@ Your environment should be all set, but let's make sure: - Run `cdv --help`. You should get another usage statement. -The CAT admin tool also comes bundled with a version of Chia. If your wallet is not currently running, be sure to start it now: +The CAT admin tool also comes bundled with a version of Chia. If your wallet is not currently running, be sure to start it now: If your wallet is not currently running, be sure to start it now: ```bash chia start wallet @@ -322,9 +337,9 @@ For a comprehensive list of all options available with the CAT admin tool, as we ### Automatic CATs -Before continuing, it is a good idea to verify that new CATs will automatically be added to your wallet. The setting for this is located in `~/.chia/mainnet/config/config.yaml`. (Note that this file is in a `mainnet` folder regardless of whether you are running on a testnet or mainnet.) +Before continuing, it is a good idea to verify that new CATs will automatically be added to your wallet. The setting for this is located in `~/.chia/mainnet/config/config.yaml`. (Note that this file is in a `mainnet` folder regardless of whether you are running on a testnet or mainnet.) The setting for this is located in `~/.chia/mainnet/config/config.yaml`. (Note that this file is in a `mainnet` folder regardless of whether you are running on a testnet or mainnet.) -Edit this file and search for `automatically_add_unknown_cats`. You are recommended to set this option's value to `true`. Be sure to restart your wallet if you modify this option, so your new CR-CATs will automatically be added to your wallet. +Edit this file and search for `automatically_add_unknown_cats`. You are recommended to set this option's value to `true`. Edit this file and search for `automatically_add_unknown_cats`. You are recommended to set this option's value to `true`. Be sure to restart your wallet if you modify this option, so your new CR-CATs will automatically be added to your wallet. If you prefer not to use this option, you can also manually add new CATs with the [add_token](/wallet-cli#add_token) command. @@ -351,7 +366,7 @@ With all of these setup steps complete, you are ready to mint CR-CATs! The process for minting Restricted CATs is nearly identical to the process for minting standard CATs. In both cases, any TAIL may be used. This tutorial will only demonstrate how to use a single-issuance TAIL. If you are interested in using other TAILs, or if you would like a more comprehensive list of instructions, see the [CAT creation tutorial](/guides/cat-creation-tutorial). -For starters, you will need to obtain an address to send the CR-CATs to after they have been minted. From the Authorized Provider's wallet run the following command: +For starters, you will need to obtain an address to send the CR-CATs to after they have been minted. From the Authorized Provider's wallet run the following command: From the Authorized Provider's wallet run the following command: ```bash chia wallet get_address --new-address @@ -373,6 +388,7 @@ Response (truncated): ```bash ... +... Profile 1: -Total Balance: 1.0 -Pending Total Balance: 1.0 @@ -383,7 +399,7 @@ Profile 1: ... ``` -In this example, we will create one thousand CR-CATs. Each CR-CAT will consist of 1000 mojos (same as standard CATs), so this example will require one million mojos, plus a transaction fee, for the issuance. +In this example, we will create one thousand CR-CATs. In this example, we will create one thousand CR-CATs. Each CR-CAT will consist of 1000 mojos (same as standard CATs), so this example will require one million mojos, plus a transaction fee, for the issuance. When minting CR-CATs, you have two options for applying restrictions: @@ -392,7 +408,7 @@ When minting CR-CATs, you have two options for applying restrictions: For this example, we will use the `-v` option. -We also need to add the `-sc` flag to select a valid coin to spend. Here is a summary of the options that will be used in this example: +We also need to add the `-sc` flag to select a valid coin to spend. Here is a summary of the options that will be used in this example: Here is a summary of the options that will be used in this example: - `-l` -- the TAIL to use - `-t` -- the address to send the CR-CATs to upon being minted @@ -408,7 +424,7 @@ And here is the example command: cats -l ./reference_tails/genesis_by_coin_id.clsp.hex -t txch1yx4tdtqksjh7mk84deglwyq4j8td8jchyc8sdgem2hnuulmhzdhqct9wpr -a 1000000 -m 100000000 -d did:chia:1w4gf5eyensd37xa0x7aj27fe4cr9tqmf46m272suve5n4q2draesd0t54c -v "test_proof1" -sc ``` -The response will list the details of a coin from your wallet. For example: +The response will list the details of a coin from your wallet. For example: For example: ```bash { @@ -419,13 +435,13 @@ The response will list the details of a coin from your wallet. For example: Name: 1d9cb45618bdd9d70a0959ab8d91cafcbc1acbf7bd31a9e5286fd30622796783 ``` -The value of `Name:` will be used next. If you received an error containing `Can't spend more than wallet balance:`, then you do not have sufficient funds to cover the amount specified in the `-a` and `-m` options. +The value of `Name:` will be used next. The value of `Name:` will be used next. If you received an error containing `Can't spend more than wallet balance:`, then you do not have sufficient funds to cover the amount specified in the `-a` and `-m` options. Next, run the same command again, but replace `-sc` with `-c 0x`, or `-c 0x1d9cb45618bdd9d70a0959ab8d91cafcbc1acbf7bd31a9e5286fd30622796783` in this example. :::warning important -When minting CR-CATs with the commands from this tutorial, you must prepend `0x` to the coin ID in the following command. If you fail to do this, the command will appear to succeed, but it will actually fail. The reasons for not showing an error are twofold: +When minting CR-CATs with the commands from this tutorial, you must prepend `0x` to the coin ID in the following command. If you fail to do this, the command will appear to succeed, but it will actually fail. The reasons for not showing an error are twofold: If you fail to do this, the command will appear to succeed, but it will actually fail. The reasons for not showing an error are twofold: 1. You are technically allowed to curry anything with this command's underlying CLVM puzzle, so omitting the `0x` is valid syntax, even though it won't work in this case. 2. The wallet client asynchronously sends the command to the node, so the wallet client does not know when the command fails. @@ -438,13 +454,13 @@ For example, this command will mint the CR-CATs using the `-c` option: cats -l ./reference_tails/genesis_by_coin_id.clsp.hex -t txch1yx4tdtqksjh7mk84deglwyq4j8td8jchyc8sdgem2hnuulmhzdhqct9wpr -a 1000000 -m 100000000 -d did:chia:1w4gf5eyensd37xa0x7aj27fe4cr9tqmf46m272suve5n4q2draesd0t54c -v "test_proof1" -c 0x1d9cb45618bdd9d70a0959ab8d91cafcbc1acbf7bd31a9e5286fd30622796783 ``` -As a result, a new spend bundle will be created for the minting. You will be prompted whether to submit it to the network: +As a result, a new spend bundle will be created for the minting. You will be prompted whether to submit it to the network: You will be prompted whether to submit it to the network: ```bash The transaction has been created, would you like to push it to the network? (Y/N) ``` -Respond with `Y` and you should be shown the `Asset ID` and `Eve Coin ID` for this CR-CAT. For example: +Respond with `Y` and you should be shown the `Asset ID` and `Eve Coin ID` for this CR-CAT. For example: For example: ```bash Successfully pushed the transaction to the network @@ -462,6 +478,7 @@ Response (truncated): ```bash ... +... CAT 3ba9e16dca39f3fb...: -Total Balance: 1000.0 (1000000 mojo) -Balance Pending VC Approval: 0.0 (0 mojo) @@ -483,11 +500,11 @@ This information is also viewable in the GUI:
-The Authorized Provider now has control of all 1000 of the issued CR-CATs. This type of CAT is distinguished in the GUI by a padlock icon and `Restricted CAT`. The Authorized Provider also possesses a VC with the required proof (`test_proof1`), so a green icon appears when viewing the CAT. +The Authorized Provider now has control of all 1000 of the issued CR-CATs. This type of CAT is distinguished in the GUI by a padlock icon and `Restricted CAT`. The Authorized Provider now has control of all 1000 of the issued CR-CATs. This type of CAT is distinguished in the GUI by a padlock icon and `Restricted CAT`. The Authorized Provider also possesses a VC with the required proof (`test_proof1`), so a green icon appears when viewing the CAT. ## Send CR-CATs -Now that you have minted the CR-CATs, you can send them elsewhere. First, we'll send some to the VC Holder's wallet, which already has a VC that contains the required proof. +Now that you have minted the CR-CATs, you can send them elsewhere. Now that you have minted the CR-CATs, you can send them elsewhere. First, we'll send some to the VC Holder's wallet, which already has a VC that contains the required proof. ### Sending from the GUI @@ -517,7 +534,7 @@ From the VC Holder's wallet, click this button to finalize the transaction:
-An on-chain transaction is required for the approval to be processed. This is necessary to guard against unauthorized wallets holding CR-CATs, as will be demonstrated later in this tutorial. Enter a transaction fee and click `APPROVE PENDING TRANSACTIONS`: +An on-chain transaction is required for the approval to be processed. An on-chain transaction is required for the approval to be processed. This is necessary to guard against unauthorized wallets holding CR-CATs, as will be demonstrated later in this tutorial. Enter a transaction fee and click `APPROVE PENDING TRANSACTIONS`: Enter a transaction fee and click `APPROVE PENDING TRANSACTIONS`:
Approve pending transactions @@ -548,7 +565,7 @@ CAT 3ba9e16dca39f3fb...: -Wallet ID: 5 ``` -From the CLI, run a standard `send` command. In this example, we will use the following flags: +From the CLI, run a standard `send` command. In this example, we will use the following flags: In this example, we will use the following flags: - `-i` -- The `Wallet ID` of the CR-CAT - `-a` -- The number of CR-CATs to send @@ -563,11 +580,12 @@ Response: ```bash Submitting transaction... +Submitting transaction... Transaction submitted to nodes: [{'peer_id': 'b3d9de85d29931c10050b56c7afb91c99141943fc81ff2d1a8425e52be0d08ab', 'inclusion_status': 'SUCCESS', 'error_msg': None}] Run 'chia wallet get_transaction -f 3152280463 -tx 0xab577bdce7fdd1be8b4e0634ad69aa5cff66f6d9dc7d26e0119d1a3a740f91e8' to get status ``` -After a few minutes, run the command from the previous command's output to view the transaction. For example: +After a few minutes, run the command from the previous command's output to view the transaction. For example: For example: ```bash chia wallet get_transaction -f 3152280463 -tx 0xab577bdce7fdd1be8b4e0634ad69aa5cff66f6d9dc7d26e0119d1a3a740f91e8 @@ -581,6 +599,8 @@ Status: Confirmed Amount sent: 100 CAT 3ba9e16dca39f3fb... To address: txch1yzjq802ym3lv9aupl6nyvv6s24fdm9wpnte2rvhk04arr3jyt4js2287gz Created at: 2023-09-22 09:21:25 +To address: txch1yzjq802ym3lv9aupl6nyvv6s24fdm9wpnte2rvhk04arr3jyt4js2287gz +Created at: 2023-09-22 09:21:25 ``` **After switching to the VC Holder's wallet**, you should see the CR-CATs that are pending approval (in this case `100.0 (100000 mojo)`): @@ -618,7 +638,7 @@ CAT 3ba9e16dca39f3fb...: -Wallet ID: 3 ``` -The VC Holder still needs to approve the new CR-CATs in order to add them to the wallet balance. This is accomplished with the `approve_r_cats` command. In this example, we will use the following flags: +The VC Holder still needs to approve the new CR-CATs in order to add them to the wallet balance. This is accomplished with the `approve_r_cats` command. In this example, we will use the following flags: This is accomplished with the `approve_r_cats` command. In this example, we will use the following flags: - `-i` -- The `Wallet ID` of the CR-CAT - `-a` -- The amount to approve @@ -680,7 +700,7 @@ In this example, as the **Authorized Provider**, click `CREATE AN OFFER` from th
-Next, fill out the Offer Builder. For this example, we will offer to trade 99 CR-CATs for 0.1 TXCH: +Next, fill out the Offer Builder. Next, fill out the Offer Builder. For this example, we will offer to trade 99 CR-CATs for 0.1 TXCH:
Offer Builder @@ -690,7 +710,7 @@ Next, fill out the Offer Builder. For this example, we will offer to trade 99 CR After creating the Offer, Authorized Provider can save it as a local file or post it to a marketplace. -For this example, we will change to the **VC Holder** wallet and load the Offer file. This wallet contains a VC with the required proof to hold this CR-CAT (`test_proof1`). Enter an optional blockchain fee and click `ACCEPT OFFER`: +For this example, we will change to the **VC Holder** wallet and load the Offer file. This wallet contains a VC with the required proof to hold this CR-CAT (`test_proof1`). Enter an optional blockchain fee and click `ACCEPT OFFER`: In this example, the recipient is the VC Holder's wallet. This wallet holds the credential with the required proof (`test_proof1`) for holding this CR-CAT. Because the proof exists, a green `APPROVE` button will appear. Enter an optional blockchain fee and click `ACCEPT OFFER`:
Accept Offer @@ -698,7 +718,7 @@ For this example, we will change to the **VC Holder** wallet and load the Offer
-While the on-chain transaction to accept the Offer is pending, the 99 CR-CATs will be displayed in the VC Holder's `Pending Balance`. Note that the `Pending Balance for Approval` is `0` in this case: +While the on-chain transaction to accept the Offer is pending, the 99 CR-CATs will be displayed in the VC Holder's `Pending Balance`. Note that the `Pending Balance for Approval` is `0` in this case: Note that the `Pending Balance for Approval` is `0` in this case:
Pending Offer Acceptance @@ -706,7 +726,7 @@ While the on-chain transaction to accept the Offer is pending, the 99 CR-CATs wi
-After the transaction has been confirmed, the balance is updated. When receiving CR-CATs via an Offer, there is no need to perform another transaction to approve of the incoming tokens. This is because the proof requirement is already baked into the Offer file. +After the transaction has been confirmed, the balance is updated. After the transaction has been confirmed, the balance is updated. When receiving CR-CATs via an Offer, there is no need to perform another transaction to approve of the incoming tokens. This is because the proof requirement is already baked into the Offer file. This is because the proof requirement is already baked into the Offer file.
Completed Offer @@ -718,7 +738,7 @@ At this point, the VC Holder wallet has full possession of the CR-CATs. ### CLI Offers -Offers for CR-CATs can also be created and accepted via the CLI. For this example, the **Authorized Provider** will create an Offer using the following flags: +Offers for CR-CATs can also be created and accepted via the CLI. Offers for CR-CATs can also be created and accepted via the CLI. For this example, the **Authorized Provider** will create an Offer using the following flags: - `-o` -- The Offer amount, using the syntax ``:`` - `-r` -- The requested amount, using the syntax ``:` -Even though the recipient is not allowed to hold these CR-CATs, the transaction itself is valid. However, just as in the examples at the beginning of this tutorial, the XCH Wallet will receive the CR-CATs in the `Pending Balance for Approval` section of the GUI. In this case, the required proof (in the red circle below) is not present. +Even though the recipient is not allowed to hold these CR-CATs, the transaction itself is valid. Even though the recipient is not allowed to hold these CR-CATs, the transaction itself is valid. However, just as in the examples at the beginning of this tutorial, the XCH Wallet will receive the CR-CATs in the `Pending Balance for Approval` section of the GUI. In this case, the required proof (in the red circle below) is not present. In this case, the required proof (in the red circle below) is not present. The XCH Wallet can still attempt to approve these CR-CATs: @@ -884,22 +904,22 @@ The status of these CR-CATs is as follows: - The XCH Wallet is not allowed to send them elsewhere - The Authorized Provider's wallet no longer holds them -Note that even though nothing can be done with the funds in this state, they are still not bricked. The XCH Wallet will gain access to the funds if it obtains a VC with the required proof. However, assuming the XCH Wallet was not supposed to hold the correct VC in the first place, the Authorized Provider will presumably be reluctant to issue a VC to this wallet. +Note that even though nothing can be done with the funds in this state, they are still not bricked. The XCH Wallet will gain access to the funds if it obtains a VC with the required proof. Note that even though nothing can be done with the funds in this state, they are still not bricked. The XCH Wallet will gain access to the funds if it obtains a VC with the required proof. However, assuming the XCH Wallet was not supposed to hold the correct VC in the first place, the Authorized Provider will presumably be reluctant to issue a VC to this wallet. :::info -For the reasons discussed above, exercise caution when sending CR-CATs to another wallet. In fact, because of the risk of making the funds difficult (if not impossible) to access, we recommend that you don't send CR-CATs in this way. +For the reasons discussed above, exercise caution when sending CR-CATs to another wallet. For the reasons discussed above, exercise caution when sending CR-CATs to another wallet. In fact, because of the risk of making the funds difficult (if not impossible) to access, we recommend that you don't send CR-CATs in this way. Instead, you should use Offers to distribute CR-CATs, as they provide two important advantages: -- If the recipient is allowed to hold the CR-CATs, they will be able to accept an Offer to receive those CATs. Once the Offer is complete, they will not need to submit an approval transaction. +- If the recipient is allowed to hold the CR-CATs, they will be able to accept an Offer to receive those CATs. Once the Offer is complete, they will not need to submit an approval transaction. Once the Offer is complete, they will not need to submit an approval transaction. - If the recipient is not allowed to hold the CR-CATs, they will not be able to accept an Offer to receive those CATs in the first place. ::: ### Offers for CR-CATs -Let's say the owner of the XCH Wallet locates a CR-CAT Offer. Upon viewing the offer, the wallet's owner will see that the required proof is grayed out, indicating that it is not present: +Let's say the owner of the XCH Wallet locates a CR-CAT Offer. Let's say the owner of the XCH Wallet locates a CR-CAT Offer. Upon viewing the offer, the wallet's owner will see that the required proof is grayed out, indicating that it is not present:
Offer where required providers missing diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md index ef9a719981..d17d335e02 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md @@ -8,7 +8,7 @@ import TabItem from '@theme/TabItem'; ## Intro -This document will show you how to use Chia's standalone clawback primitive. 欢迎钱包开发者将其整合到开发的GUI钱包中。 +This document will show you how to use Chia's standalone clawback primitive. 欢迎钱包开发者将其整合到开发的GUI钱包中。 欢迎钱包开发者将其整合到开发的GUI钱包中。 有关其他技术资源，请参阅以下内容： @@ -18,17 +18,17 @@ This document will show you how to use Chia's standalone clawback primitive. 欢 :::warning 一些重要提醒 -- The standalone clawback primitive doesn't implement wallet functionality to handle incoming clawbacks and resync deleted coin stores. Rather, it's for developers to understand the process of how clawbacks work. -- Chia Network, Inc has added a user-friendly implementation of the clawback primitive to version 1.8.2 of the reference wallet. +- The standalone clawback primitive doesn't implement wallet functionality to handle incoming clawbacks and resync deleted coin stores. Rather, it's for developers to understand the process of how clawbacks work. Rather, it's for developers to understand the process of how clawbacks work. +- Chia Network Inc has added a user-friendly implementation of the clawback primitive to version 1.8.2 of the reference wallet. - A **synced full node** AND a synced wallet are required to use the clawback primitive. -- You are recommended to test the clawback primitive on either the testnet or a simulator before moving to mainnet. For your reference, this guide will use testnet10. +- You are recommended to test the clawback primitive on either the testnet or a simulator before moving to mainnet. For your reference, this guide will use a testnet. - The clawback primitive currently only supports XCH/TXCH. It does not support CATs or NFTs. The `-w` flag will be ignored if it points to a non-XCH (or TXCH) wallet. ::: --- -### 关于可撤回交易（clawback） +## 关于可撤回交易（clawback） 可撤回交易原语的目的是防止将Chia资产发送到一个错误的地址。 可撤回交易的原理很简单：它是一种中间硬币，直到时间锁定过期之前，无法发送到目标地址。 与此同时，发送者可以"撤回"该硬币，将其以标准XCH的形式退回到他们的钱包中。 @@ -43,7 +43,7 @@ This document will show you how to use Chia's standalone clawback primitive. 欢 - It contains Alice's address as its clawback destination (Alice -- and no one else -- can modify this later) - It contains Bob's address as its final destination (Bob -- and no one else -- can modify this later) - The clawback coin therefore contains the following logic for how it may be spent: - - Before 1 hour has elapsed since the coin's creation, Alice can use [p2_1_of_n](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/p2_m_of_n_delegate_direct.clvm) to spend the coin using the same public/private key pair that created the coin. When the coin is spent in this way, a new coin is created using [p2_puzzle_hash](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/p2_puzzle_hash.clvm). Typically, this coin will be created in Alice's wallet, but it could be created in another wallet instead. The new coin uses the standard Chia puzzle. This is the `clawback` case. + - Before 1 hour has elapsed since the coin's creation, Alice can use [p2_1_of_n](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/p2_m_of_n_delegate_direct.clvm) to spend the coin using the same public/private key pair that created the coin. When the coin is spent in this way, a new coin is created using [p2_puzzle_hash](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/p2_puzzle_hash.clvm). Typically, this coin will be created in Alice's wallet, but it could be created in another wallet instead. The new coin uses the standard Chia puzzle. This is the `clawback` case. When the coin is spent in this way, a new coin is created using [p2_puzzle_hash](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/puzzles/p2_puzzle_hash.clvm). Typically, this coin will be created in Alice's wallet, but it could be created in another wallet instead. The new coin uses the standard Chia puzzle. This is the `clawback` case. - Before 1 hour has elapsed since the coin's creation, nobody other than Alice may spend it - After 1 hour, the timelock elapses. At this point Bob can spend the clawback coin. When this spend occurs, by default a new standard XCH coin is created in Bob's wallet. Bob can also pass in a different address than the one he originally specified if he so chooses. - Note that the coin's clawback logic is in place for the life of the coin. This means that until the coin is spent, Alice is able to claw it back. This is true regardless of the coin's age. Because of this, after the timelock expires, Bob must spend the clawback coin in order to receive the XCH in his wallet. After this spend has completed, the clawback coin no longer exists, and the spend is final. @@ -66,7 +66,7 @@ The values used in the commands from this guide are just examples. You will need --- -### Install the clawback primitive +## Install the clawback primitive The clawback primitive is included in the `Chia-Network` organization's `chia-clawback-primitive` GitHub repository. @@ -105,6 +105,7 @@ python -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate +``` ./venv/bin/activate ``` @@ -113,6 +114,7 @@ python3 -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate +``` ./venv/bin/activate ``` @@ -142,7 +144,7 @@ At this point, you are ready to use the clawback primitive. --- -### Create a clawback coin +## Create a clawback coin For this example, we will use two wallets: a Sender and a Recipient. The Sender has a balance of 10 TXCH and the Recipient has 0 TXCH. @@ -209,7 +211,7 @@ Timelock: 600 seconds Time left: 518 seconds ``` -### Claw back a coin +## Claw back a coin This guide will continue from the previous section, where we created a new clawback coin, which has not yet been spent. As a reminder, these are the clawback coin's details: @@ -280,7 +282,7 @@ Chia Wallet: At this point, the clawback coin no longer exists. The Sender is of course free to create new clawback coins as they see fit. -### Claim a clawback coin +## Claim a clawback coin In this section, we'll show how to claim a clawback coin. First, the Sender creates a new clawback coin with a 60-second timelock: @@ -392,7 +394,7 @@ However, there is a small window of time where the timer has expired, but a bloc You are trying to claim the coin too early ``` -In this case, the Recipient needs to wait for one more transaction block to be farmed before proceeding with the `claim` call. As a reminder, a new transaction block is farmed every 52 seconds, on average. +In this case, the Recipient needs to wait for one more transaction block to be farmed before proceeding with the `claim` call. As a reminder, a new transaction block is farmed every 52 seconds, on average. As a reminder, a new transaction block is farmed every 52 seconds, on average. ::: @@ -442,11 +444,11 @@ The spend is now complete and can no longer be clawed back. The funds are stored --- -### Other cases +## Other cases So far, we have shown the standard clawback and completion spends. There are also a few edge cases and errors worth discussing. -#### Sender performs a clawback after the timelock +### Sender performs a clawback after the timelock After the timelock expires, the Recipient may claim the clawback coin. Until this is done, the Sender can still claw back the coin. @@ -532,7 +534,7 @@ Chia Wallet: Because the Sender can always claw back a clawback coin while it exists, the Recipient cannot assume that they will receive the clawback coin, even after the timelock has expired. However, after the Recipient has claimed the clawback coin and it has appeared in the Recipient's wallet as regular XCH/TXCH, the coin can no longer be clawed back. -#### Recipient attempts to claim clawback coin before timelock has expired +### Recipient attempts to claim clawback coin before timelock has expired Before the timelock expires, a clawback coin may not be spent to its Recipient's address. For example, let's say the following clawback coin exists. Note that its `Time left:` is still greater than 0 seconds: @@ -564,7 +566,7 @@ Result: You are trying to claim the coin too early ``` -#### Someone other than the Sender attempts to claw back a coin +### Someone other than the Sender attempts to claw back a coin For this example, the Sender creates a new clawback coin: @@ -653,7 +655,7 @@ Traceback (most recent call last): ValueError: Couldn't find a matching key for puzzle hash: ee3144040e80747af2f6ec56ed7567d22ca83ea3470e09bb9d95347a80cd2d29. ``` -#### Someone other than the Recipient attempts to claim a clawback spend +### Someone other than the Recipient attempts to claim a clawback spend For this example, someone other than the Recipient is made aware of the Coin ID of a pending clawback coin: @@ -715,7 +717,7 @@ Traceback (most recent call last): ValueError: Couldn't find a matching key for puzzle hash: c08dfae2aab3b3b3cbffdd4c1f1e4bf2df278785e5ca67524d6e518e79f134c3. ``` -#### Sender claws back coin to a new wallet +### Sender claws back coin to a new wallet The Sender has the option of performing a clawback where the coin is sent to any wallet. Let's say the Sender creates a clawback coin: @@ -763,7 +765,7 @@ Chia Wallet: -Wallet ID: 1 ``` -#### Recipient claims a clawback coin in a new wallet address +### Recipient claims a clawback coin in a new wallet address The Recipient also has the option of spending a clawback coin to a new address. @@ -833,7 +835,7 @@ Chia Wallet: -Wallet ID: 1 ``` -#### Sender or Recipient attempts to show a clawback coin before it has been created +### Sender or Recipient attempts to show a clawback coin before it has been created Two important rules to keep in mind: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md index 62fcaa8bfe..cda71653b8 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md @@ -8,7 +8,7 @@ import TabItem from '@theme/TabItem'; ## Intro -This document is a guide for using the clawback functionality introduced in version 1.8.2 of Chia's reference wallet. _Clawback_ is a new feature that offers protection against sending XCH to the wrong address. +This document is a guide for using the clawback functionality introduced in version 1.8.2 of Chia's reference wallet. This document is a guide for using the clawback functionality introduced in version 1.8.2 of Chia's reference wallet. _Clawback_ is a new feature that offers protection against sending XCH to the wrong address. If you are a developer or a CLI user, see the following resources for more info: @@ -18,8 +18,8 @@ If you are a developer or a CLI user, see the following resources for more info: In order to use Chia clawbacks, you must have: -- Version 1.8.2 or later of Chia's reference light wallet or full node. See our [downloads page](https://www.chia.net/downloads/) to obtain a copy. -- A sufficient amount of XCH or TXCH to send a transaction and pay fees. If you do not have a sufficient amount, you can obtain some from our [mainnet](https://faucet.chia.net/) and [testnet](https://testnet10-faucet.chia.net/) faucets. +- Version 1.8.2 or later of Chia's reference light wallet or full node. See our [downloads page](https://www.chia.net/downloads/) to obtain a copy. See our [downloads page](https://www.chia.net/downloads/) to obtain a copy. +- A sufficient amount of XCH or TXCH to send a transaction and pay fees. A sufficient amount of XCH or TXCH to send a transaction and pay fees. If you do not have a sufficient amount, you can obtain some from our [mainnet](https://faucet.chia.net/) and [testnet](https://testnet10-faucet.chia.net/) faucets. --- @@ -35,11 +35,11 @@ The following demonstrates an example workflow of this process: - The sender and receiver both see the pending 1-XCH transaction in their wallets - The sender can choose to return the 1 XCH to his/her wallet (this is a _clawback_) - The receiver cannot yet claim the money - - The sender and receiver could communicate off-chain. For example, the sender could call the receiver and ask if the pending transaction appears in their wallet. + - The sender and receiver could communicate off-chain. The sender and receiver could communicate off-chain. For example, the sender could call the receiver and ask if the pending transaction appears in their wallet. - If yes, then both parties can be confident that the money was sent to the correct address - If no, then the money was sent to an incorrect address, so the sender will claw it back 4. After 10 minutes, if the sender has not clawed the 1 XCH back, the receiver can claim it -5. After the receiver has claimed the money, it appears in both wallets as a normal transaction. At this point, the transaction is complete; clawback is no longer possible +5. After the receiver has claimed the money, it appears in both wallets as a normal transaction. At this point, the transaction is complete; clawback is no longer possible At this point, the transaction is final. It can no longer be clawed back. The "intermediate location" is actually a coin with two rules: @@ -56,7 +56,7 @@ This guide will show you how to perform the above workflow. ### Review Settings -Before initiating a clawback transaction, it's a good idea to review your wallet's settings. Click `Settings` (the gear icon in the lower-left corner of your wallet) and click the `CUSTODY` menu. +Before initiating a clawback transaction, it's a good idea to review your wallet's settings. Click `Settings` (the gear icon in the lower-left corner of your wallet) and click the `CUSTODY` menu. Click `Settings` (the gear icon in the lower-left corner of your wallet) and click the `CUSTODY` menu. From this menu: @@ -82,8 +82,8 @@ From the `SEND` menu as shown below, enter the recipient's address, the amount t :::note -- Prior to initiating the transaction, the sender's wallet from this example contained 5 TXCH. The amount to be sent was 1 TXCH. -- This example was executed on Chia's testnet, which has higher fee requirements than mainnet. For this reason, a large fee of 100 million mojos was added. +- Prior to initiating the transaction, the sender's wallet from this example contained 5 TXCH. The amount to be sent was 1 TXCH. The amount to be sent was 1 TXCH. +- This example was executed on Chia's testnet, which has higher fee requirements than mainnet. For this reason, a large fee of 100 million mojos was added. For this reason, a large fee of 100 million mojos was added. ::: @@ -100,7 +100,7 @@ After you have entered these parameters, click the dropdown for `Add option to c --- -Add the time (days, minutes, hours) during which the transaction will be able to be clawed back. In this case, we'll use 10 minutes. +Add the time (days, minutes, hours) during which the transaction will be able to be clawed back. In this case, we'll use 10 minutes. In this case, we'll use 10 minutes. Optionally add a memo to describe this transaction, and click `SEND`. @@ -115,7 +115,7 @@ Optionally add a memo to describe this transaction, and click `SEND`. --- -The transaction has been added to the mempool. This means that it is still in the `Pending` state for inclusion on the blockchain. At this point, there is no indication in the GUI that this is a clawback transaction. +The transaction has been added to the mempool. This means that it is still in the `Pending` state for inclusion on the blockchain. The transaction has been added to the mempool. This means that it is still in the `Pending` state for inclusion on the blockchain. At this point, there is no indication in the GUI that this is a clawback transaction.
-At this point, the transaction is final. The sender has the same amount of XCH they started with, minus the two transaction fees. Due to the clawback, the original "receiver" did not receive anything. +At this point, the transaction is final. At this point, the transaction is final. The sender has the same amount of XCH they started with, minus the two transaction fees. Due to the clawback, the original "receiver" did not receive anything. Due to the clawback, the original "receiver" did not receive anything. --- @@ -196,7 +196,7 @@ To avoid confusion, the sender's wallet in this example uses a light theme, and ::: -Just like before, start by creating a new transaction and adding a clawback time and an optional memo. We'll use 10 minutes in this example. +Just like before, start by creating a new transaction and adding a clawback time and an optional memo. We'll use 10 minutes in this example. We'll use 10 minutes in this example.
@@ -48,6 +49,9 @@ python3 -m venv venv . ./venv/bin/activate python -m pip install --upgrade pip setuptools wheel pip install . +``` ./venv/bin/activate +python -m pip install --upgrade pip setuptools wheel +pip install . ``` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp-and-typescript.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp-and-typescript.md index f8ada3518b..89527d0016 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp-and-typescript.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp-and-typescript.md @@ -19,10 +19,10 @@ You can do RPC calls with pretty much any language, but to create larger applica This guide is meant to be an example that will give you some basic experience. We will be using Node.js with TypeScript to create a signature enforced coin. We'll use multiple TypeScript libraries for this project, which are open source if you want to see the details on how they work. -- [BLS Signatures](https://npmjs.com/package/@rigidity/bls-signatures) -- [CLVM](https://npmjs.com/package/@rigidity/clvm) -- [RPCs](https://npmjs.com/package/@rigidity/chia) -- [Wallet Helper](https://npmjs.com/package/@rigidity/chia-wallet) +- [BLS Signatures](https://npmjs.com/package/chia-bls) +- [CLVM](https://npmjs.com/package/clvm-lib) +- [RPCs](https://npmjs.com/package/chia-rpc) +- [Wallet Helper](https://npmjs.com/package/chia-wallet-lib) - [DotEnv](https://npmjs.com/package/dotenv) - [BIP39](https://npmjs.com/package/bip39) @@ -176,19 +176,14 @@ If you use Git, you'll want to make sure the `.env` file is added to the `.gitig To not have to mention imports throughout the doc, Our imports will ultimately look like: ```ts -import { - PrivateKey, - fromHex, - AugSchemeMPL, - concatBytes, -} from "@rigidity/bls-signatures"; +import { PrivateKey, fromHex, AugSchemeMPL, concatBytes } from "chia-bls"; import { mnemonicToSeedSync } from "bip39"; import dotenv from "dotenv"; -import { Program } from "@rigidity/clvm"; +import { Program } from "clvm-lib"; import fs from "fs"; import path from "path"; -import { FullNode, formatHex, SpendBundle, toCoinId } from "@rigidity/chia"; -import { KeyStore, StandardWallet } from "@rigidity/chia-wallet"; +import { FullNode, formatHex, SpendBundle, toCoinId } from "chia-rpc"; +import { KeyStore, StandardWallet } from "chia-wallet-lib"; import os from "os"; ``` @@ -291,7 +286,7 @@ You can retrieve your network's Genesis challenge in the terminal with: chia show -s ``` -Testnet10 has the genesis `ae83525ba8d1dd3f09b277de18ca3e43fc0af20d20c4b3e92ef2a48bd291ccb2`. You can see this in `~/.chia/mainnet/config/config.yaml` as well with: +Testnet10 has the genesis `ae83525ba8d1dd3f09b277de18ca3e43fc0af20d20c4b3e92ef2a48bd291ccb2`. You can see this in `~/.chia/mainnet/config/config.yaml` as well with: You can see this in `~/.chia/mainnet/config/config.yaml` as well with: ```bash less ~/.chia/mainnet/config/config.yaml @@ -384,7 +379,7 @@ npm run start ## Crafting a Solution -THe solution for this puzzle consists of a list of conditions. To write Chialisp within JavaScript we can use the `Program.fromSource()` method. We will use a `51` (`CREATE_COIN`) condition delivering the value to our wallet puzzle hash. +The solution for this puzzle consists of a list of conditions. To write Chialisp within JavaScript we can use the `Program.fromSource()` method. We will use a `51` (`CREATE_COIN`) condition delivering the value to our wallet puzzle hash. ```typescript // Calculate an unused address we can send the value to. @@ -455,19 +450,14 @@ Which should produce the following result: Complete Code ```typescript -import { - PrivateKey, - fromHex, - AugSchemeMPL, - concatBytes, -} from "@rigidity/bls-signatures"; +import { PrivateKey, fromHex, AugSchemeMPL, concatBytes } from "chia-bls"; import { mnemonicToSeedSync } from "bip39"; import dotenv from "dotenv"; -import { Program } from "@rigidity/clvm"; +import { Program } from "clvm-lib"; import fs from "fs"; import path from "path"; -import { FullNode, formatHex, SpendBundle, toCoinId } from "@rigidity/chia"; -import { KeyStore, StandardWallet } from "@rigidity/chia-wallet"; +import { FullNode, formatHex, SpendBundle, toCoinId } from "chia-rpc"; +import { KeyStore, StandardWallet } from "chia-wallet-lib"; import os from "os"; dotenv.config(); diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp.md index 96f1d979d8..8553e7b26e 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/chialisp.md @@ -122,7 +122,7 @@ Which should produce the following output: 42 ``` -So Chialisp can calculate the [meaning of life]()! +So Chialisp can calculate the [meaning of life](https://en.wikipedia.org/wiki/42_(number)#The_Hitchhiker's_Guide_to_the_Galaxy)! --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md index f3852f4042..c8796dea15 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md @@ -132,7 +132,7 @@ Which should produce the following output: 42 ``` -So Chialisp can calculate the [meaning of life]()! +So Chialisp can calculate the [meaning of life](https://en.wikipedia.org/wiki/42_(number)#The_Hitchhiker's_Guide_to_the_Galaxy)! --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/introduction.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/introduction.md index 0ed1abf190..9e2f12c48d 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/introduction.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/introduction.md @@ -264,6 +264,24 @@ Genesis Challenge: ae83525ba8d1dd3f09b277de18ca3e43fc0af20d20c4b3e92ef2a48bd291c Current Blockchain Status: Not Synced. Peak height: 1462514 Time: Wed Aug 31 2022 13:49:51 EDT Height: 1462514 +Estimated network space: 1.181 TiB +Current difficulty: 708 +Current VDF sub_slot_iters: 70778880 +Total iterations since the start of the blockchain: 3364480016373 + + Height: | Hash: + 1462514 | d799fedae1ef226669f61ad843c5ae7947b42e596664f39fd68fcd299e076916 + 1462513 | 0764f546d9186da788485ce69ebe91969e8cf9495722d9567d67e54e3e3e6ed3 + 1462512 | d6132b015365b7609d0b5179b9daf9e4fd2ad7a9040ec1d13e15df65660cf69e + 1462511 | 8ae2273b4a86fd9af85837c538faa75b572014ac281c6c51ad1eb4ce2a7f8072 + 1462510 | fb392a40b7e3bf38c8628311224b5aaa4a32ecdea403c16ae5d3c48d16b57f47 + 1462509 | 012b1f9213bf823e6b73408019f18ff8330e46b911ba78c1d64fd5019d6cc6d9 + 1462508 | e0f66ca2e00566eee9a3ce4028b6aa11771aa42c9bce34f296d89f42d1a909ce + 1462507 | c900e2fb449db0def030a3c0e6a8bff5d23f6470730236120bcac442b2f1ab0f + 1462506 | 39db9fe7658b545dcf45e8e99797c937b7b93a041485ef28bf9cda2b3529ac0a + 1462505 | ca343b0e985fe9dafb7cba7cee0c1515c6bddd732e2542b8fbd49ac8d90c13f3 Peak height: 355514 + Time: Wed Feb 14 2024 13:49:51 EDT Height: 355514 + Estimated network space: 1.181 TiB Current difficulty: 708 Current VDF sub_slot_iters: 70778880 @@ -288,7 +306,7 @@ Ideally, you'll see within this response a value like `Current Blockchain Status
Testnet Database -For many things you will need a synced full node. Fortunately, an official [testnet database](https://downloads.chia.net/testnet10/) download is available, which can be a much faster option than syncing from scratch. +For many things you will need a synced full node. For many things you will need a synced full node. Fortunately, an official [testnet database](https://downloads.chia.net/testnet10/) download is available, which can be a much faster option than syncing from scratch. Once this file is downloaded, stop your node: @@ -314,7 +332,7 @@ chia show --state ## Getting TXCH -For the rest of this workshop you will need some TXCH (Testnet Chia). You can get some for free from the [official Chia faucet](https://testnet10-faucet.chia.net/). +For the rest of this workshop you will need some TXCH (Testnet Chia). You can get some for free from the [official Chia faucet](https://testnet11-faucet.chia.net/). For this you will need a receive address. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/signatures.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/signatures.md index d0ee8890a2..1400aa87a4 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/signatures.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/signatures.md @@ -350,7 +350,7 @@ To sign the message we will actually need the `coin_id` and the genesis challeng less ~/.chia/mainnet/config/config.yaml ``` -and then search for `genesis_challenge`, picking the one for the appropriate network (such as testnet10). The value will be a hex string such as `ae83525ba8d1dd3f09b277de18ca3e43fc0af20d20c4b3e92ef2a48bd291ccb2` (that is the value for testnet10). +and then search for `genesis_challenge`, picking the one for the appropriate network (such as testnet10). The value will be a hex string such as `ae83525ba8d1dd3f09b277de18ca3e43fc0af20d20c4b3e92ef2a48bd291ccb2` (that is the value for testnet10). ::: The value will be a hex string such as `37a90eb5185a9c4439a91ddc98bbadce7b4feba060d50116a067de66bf236615` (that is the value for testnet11). ::: ## Get Coin Id diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/state.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/state.md index 57a86f85a7..38c48f9ea9 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/state.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/state.md @@ -280,6 +280,12 @@ cdv clsp build message.clsp ## Initial Setup +Install NPM: + +```bash +pip install npm +``` + Install the needed dependencies: ```bash @@ -404,6 +410,13 @@ GENESIS=d25b25b897564035695996922aa0f9ff9d611bd38cd2ecd0d2383a99a70dfc15 EVE_COIN_ID=5fe284bfa91c32fd274179769f5b808c916e5135e603cb292a90e04e5867bd1a ``` +:::info +The hash used in `GENESIS` can be found in your chia environments config.yaml file. +Mainnet Genesis = `ccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb` +Testnet11 Genesis = `37a90eb5185a9c4439a91ddc98bbadce7b4feba060d50116a067de66bf236615` +For the simulator and other testnets please refer to the instances config.yaml `$CHIA_ROOT/config/config.yaml`. +::: + Write the following code to sync the state: ```ts title=index.ts diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md index 42bf2bfe49..018c9f50b9 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md @@ -42,7 +42,7 @@ The singleton comes in two layers -- one permanent and one non-permanent. ### Permanent layer | Setting | Prefarm Value | Description | -| :------ | :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------- |:------------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `wt` | 30 days | Withdrawal Timelock -- When attempting to begin a withdrawal, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback. | | `pc` | 90 days | Payment Clawback -- The minimum number of seconds that must elapse after initiating a withdrawal before the withdrawal can be completed. Clawbacks are possible during this window. | | `rt` | 15 days | Rekey Timelock -- When attempting to begin a standard rekey, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback. For a slow rekey, this amount gets added for each key less than `m` (in addition to the amount of time that would have been required in a standard rekey). | @@ -52,10 +52,10 @@ The singleton comes in two layers -- one permanent and one non-permanent. ### Non-permanent layer | Setting | Initial
Value | Description | -| :------ | :---------------- | :-------------------------------------------------------------------------- | -| `m` | 3 | The initial number of pubkeys required to do a withdrawal or standard rekey | -| `n` | 5 | The maximum number of pubkeys required to do a withdrawal or standard rekey | -| `pks` | | A comma separated list of pubkey files that will control this money | +|:------- |:----------------------- |:--------------------------------------------------------------------------- | +| `m` | 3 | The initial number of pubkeys required to do a withdrawal or standard rekey | +| `n` | 5 | The maximum number of pubkeys required to do a withdrawal or standard rekey | +| `pks` | | A comma separated list of pubkey files that will control this money | ## Allowed Actions @@ -123,10 +123,10 @@ The amount of time before the rekey can begin depends on the number of keys used The following table illustrates a few examples of initiation timelock lengths, for various values of `m` and `k`. For this table, `rt` is set to 15 days and `sp` is set to 45 days (these are both denominated in seconds). The table assumes that `n` (5) and the minimum `k` (1) have not been modified from their default values: | `m` | `k` | Days | Comment | -| :-: | :-: | :--: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:---:|:---:|:----:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 3 | 3 | 15 | Standard rekey, no penalty | -| 3 | 2 | 75 | Slow rekey, `sp` day penalty + 2 \* standard `rt` days | -| 3 | 1 | 90 | Slow rekey, `sp` day penalty + 3 \* `rt` days | +| 3 | 2 | 75 | Slow rekey, `sp` day penalty + 2 \* standard `rt` days | +| 3 | 1 | 90 | Slow rekey, `sp` day penalty + 3 \* `rt` days | | 1 | 1 | 15 | This is a case where, after a prior rekey, `m` was reduced to 1. There is no penalty, even with a single key | | 5 | 3 | 90 | In this case, a lock level increase has been performed, so 5 of 5 keys are required to avoid a penalty | | 5 | 1 | 120 | This is the longest possible initiation timelock duration when `n` is 5 and the minimum `k` is 1. In this case, `m` has been increased to 5, and 1 key is being used for the rekey | @@ -190,11 +190,11 @@ The following table lists the action/consequence, given the current value of `m`
-| `m` | Keys Sniffed | Keys Stolen | Keys Lost | -| :-- | :------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------- | :------------------------------------------------------- | -| 3 | 0-2: normal rekey
3: lock level increase to 4, normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-2: normal rekey
3-5: drained | 0-2: normal rekey
3-4: slow rekey
5: bricked | -| 4 | 0-3: normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-1: normal rekey
2: slow rekey
3-5: drained | 0-1: normal rekey
2-4: slow rekey
5: bricked | -| 5 | 0-4: normal rekey
5: deadlocked | 0: normal rekey
1-2: slow rekey
3-5: drained | 0: normal rekey
1-4: slow rekey
5: bricked | +| `m` | Keys Sniffed | Keys Stolen | Keys Lost | +|:--- |:------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------------------------------------------------------------------- |:-------------------------------------------------------------------- | +| 3 | 0-2: normal rekey
3: lock level increase to 4, normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-2: normal rekey
3-5: drained | 0-2: normal rekey
3-4: slow rekey
5: bricked | +| 4 | 0-3: normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-1: normal rekey
2: slow rekey
3-5: drained | 0-1: normal rekey
2-4: slow rekey
5: bricked | +| 5 | 0-4: normal rekey
5: deadlocked | 0: normal rekey
1-2: slow rekey
3-5: drained | 0: normal rekey
1-4: slow rekey
5: bricked | --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md index 4e0d0605bd..8dfbc98c62 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md @@ -80,6 +80,7 @@ python -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate +``` ./venv/bin/activate ``` @@ -88,6 +89,7 @@ python3 -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate +``` ./venv/bin/activate ``` @@ -246,13 +248,13 @@ The `cic init` command will initialize the permanent layer of the singleton. **N For this guide, we'll create an example singleton that uses the values listed in the table below. As a reminder, these settings correspond to those used in the [flow chart](https://docs.chia.net/assets/files/chia-custody-tool-5e6e2f18e8f98c0faaf11bdf5fea5971.png). | Flag  | Example
Value | Description | -| :--------- | :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-d` | keys_and_sb | The directory where the keys and spend bundles will be stored. | -| `-wt` | 600 seconds | Withdrawal Timelock -- the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback before a withdrawal can be initiated. | -| `-pc` | 1200 seconds | Payment Claw back -- the minimum number of seconds that must elapse after initiating a withdrawal before the withdrawal can be completed. Clawbacks are possible during this window. | -| `-rt` | 300 seconds | Rekey Timelock -- when attempting to begin a standard rekey, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or claw back. For a slow rekey, this amount gets added for each key less than `m`. | -| `-rc` | 600 seconds | Rekey Claw back -- the minimum number of seconds that must elapse after initiating a rekey before the rekey can be completed. Claw backs are possible during this window. | -| `-sp` | 900 seconds | Slow rekey Penalty -- this amount gets added to the Rekey Timelock when a slow rekey is being performed. | +|:---------- |:----------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `-d` | keys_and_sb | The directory where the keys and spend bundles will be stored. | +| `-wt` | 600 seconds | Withdrawal Timelock -- the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback before a withdrawal can be initiated. | +| `-pc` | 1200 seconds | Payment Claw back -- the minimum number of seconds that must elapse after initiating a withdrawal before the withdrawal can be completed. Clawbacks are possible during this window. | +| `-rt` | 300 seconds | Rekey Timelock -- when attempting to begin a standard rekey, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or claw back. For a slow rekey, this amount gets added for each key less than `m`. | +| `-rc` | 600 seconds | Rekey Claw back -- the minimum number of seconds that must elapse after initiating a rekey before the rekey can be completed. Claw backs are possible during this window. | +| `-sp` | 900 seconds | Slow rekey Penalty -- this amount gets added to the Rekey Timelock when a slow rekey is being performed. | :::info notes regarding the above table diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md index b3373aaad7..cb5d4e9b59 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md @@ -3,7 +3,7 @@ slug: /custody/prefarm-audit-tutorial title: Prefarm Audit Tutorial --- -Chia Network Inc's prefarm is secured by a complex set of custodial rules. This document describes how to use the custody tool to audit the prefarm configuration. A moderate level of technical proficiency is probably needed to understand the details. For a high-level overview of the prefarm custody wallets, see our [blog post](https://www.chia.net/2022/10/29/a-new-home-for-the-prefarm/). +Chia Network Inc's prefarm is secured by a complex set of custodial rules. This document describes how to use the custody tool to audit the prefarm configuration. A moderate level of technical proficiency is probably needed to understand the details. For a high-level overview of the prefarm custody wallets, see our [blog post](https://www.chia.net/2022/10/29/a-new-home-for-the-prefarm/). This document describes how to use the custody tool to audit the prefarm configuration. A moderate level of technical proficiency is probably needed to understand the details. For a high-level overview of the prefarm custody wallets, see our [blog post](https://www.chia.net/2022/10/29/a-new-home-for-the-prefarm/). Other relevant documents: @@ -76,7 +76,7 @@ xch1jj0gm4ahhlu3ke0r0fx955v8axr6za7rzz6hc0y26lewa7zw6fws5nwvv6 :::info -NOTE: A high level of technical proficiency is needed to understand the details of this manual process for what the cic tool does above. This process is a high-level guide and does not display expected results for each step. The [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools#install) are needed for this audit. +NOTE: A high level of technical proficiency is needed to understand the details of this manual process for what the cic tool does above. This process is a high-level guide and does not display expected results for each step. NOTE: A high level of technical proficiency is needed to understand the details of this manual process for what the cic tool does above. This process is a high-level guide and does not display expected results for each step. The [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools#install) are needed for this audit. ::: @@ -91,7 +91,7 @@ NOTE: A high level of technical proficiency is needed to understand the details 4. `BASE_REKEY_TIMELOCK` = integer of the rekey timelock. 5. `SLOW_REKEY_PENALTY` = integer of the slow rekey penalty. 3. Curry the necessary parameters into singleton_top_layer_v1_1.clsp `(SINGLETON_STRUCT INNER_PUZZLE)`: - 1. `SINGLETON_STRUCT` = a tree with the following elements in order `(MOD_HASH . (LAUNCHER_ID . LAUNCHER_PUZZLE_HASH))`: + 1. `SINGLETON_STRUCT` = a tree with the following elements in order `(MOD_HASH . (LAUNCHER_ID . LAUNCHER_PUZZLE_HASH))`: (LAUNCHER_ID . LAUNCHER_PUZZLE_HASH)): 1. `MOD_HASH` = singleton_top_layer puzzle sha256 tree hash without its curried arguments. 2. `LAUNCHER_ID` = the ID of the singleton we are committed to paying. 3. `LAUNCHER_PUZZLE_HASH` = the puzzle hash of the launcher. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-cli-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-cli-guide.md index 4db1e71076..a3a06ee3c0 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-cli-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-cli-guide.md @@ -94,6 +94,12 @@ Coin ID: 0xde53700207e23c74088bd6feaadf39f36248729880ffe112b9420fa27c861d5c ::: +:::note + +This guide will use a CLI command to create a DAO. If preferred, you can also create a DAO with the [create_new_wallet](/wallet-rpc/#create_new_wallet) wallet RPC (see Example 4). + +::: + The command to create a DAO is `chia dao create`. This command contains many options -- see [the documentation](/dao-cli#create) for a complete list. Most of the options are not required. However, we will change several of them because their default values are more appropriate for real-world DAOs. For this example, we will specify the following values: @@ -274,6 +280,12 @@ The DAO now has 5 TXCH in its treasury. But there isn't much point in creating a ### Join a DAO +:::note + +This guide will use a CLI command to join an existing DAO. If preferred, you can also join a DAO with the [create_new_wallet](/wallet-rpc/#create_new_wallet) wallet RPC (see Example 5). + +::: + For this example, we will begin with a wallet that contains 3 TXCH. This will become the wallet for **DAO participant 1**: ```bash diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-known-issues.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-known-issues.md index e79d65ea9c..b8128c96f6 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-known-issues.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/dao/dao-known-issues.md @@ -6,7 +6,9 @@ title: DAO Known Issues import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -This page contains a comprehensive list of known DAO issues. Be sure to read this list carefully before using the DAO primitive. +DAOs are currently under development. Be sure to read this list carefully before using the DAO primitive. + +As of Chia version 2.1.4, the following DAO issues are known to exist: ## Proposal Spam @@ -14,7 +16,10 @@ Under normal circumstances, an attacker can create a malicious proposal to drain However, prior to creating this proposal, the attacker can use proposal spam to improve the chances of the attack's success. -The DAO wallet subscribes to `PROPOSAL` coins by hinting the `TREASURY_ID` in the `memos` field upon the coin's creation. There is a limit on the number of items a `full_node` will return to a wallet based on a subscribed puzzle_hash (including hinted coins): \* `trusted_max_subscribe_response_items`: 500000 \* `max_subscribe_response_items`: 100000 +The DAO wallet subscribes to `PROPOSAL` coins by hinting the `TREASURY_ID` in the `memos` field upon the coin's creation. To release the coins, launch the wallet from `main`, and then run the [release_coins](/dao-cli#release_coins) command. + +- There is a limit on the number of items a `full_node` will return to a wallet based on a subscribed puzzle_hash (including hinted coins): \* `trusted_max_subscribe_response_items`: 500000 \* `max_subscribe_response_items`: 100000 +- Mitigation: This issue only exists in the 2.1.2 release. The attacker can take advantage of this limit by creating multiple coins, each of which contains a hint equal to the `TREASURY_ID`. Eventually a wallet will no longer get any additional coin states for newer coins from a `full_node` via the coin state subscription. This is the "proposal spam" part of the attack. @@ -31,8 +36,8 @@ In the event that such proposals are voted on by users, because the proposals ca The current mitigation to this is that the wallet will filter out any proposals which either don't meet the proposal minimum amount or don't have valid timer coins. It is strongly suggested to use the `show_proposal` command with any proposal that you intend to vote on, and check that it is valid. -## Resync with locked DAO CATs +## Changing a DAO's settings -This issue occurs when you have a balance of locked DAO CATs which have voted on one or more open proposals, then you delete and resync the wallet DB. Once the proposals have closed, attempting to unlock the coins from voting mode will fail due to missing lineage proofs for the locked coins. +Because each proposal is voted on and enacted independently, it is possible to have a situation where a proposal to change one or more of the DAO's settings passes while another proposal is active. In this case, the active proposal will take on the _new_ rules imposed by the proposal to change the DAO's settings. This situation could cause the existing proposal to fail, even if it would have passed under the original rules. Other side effects are also possible. -Mitigation: This issue only exists in the 2.1.2 release. It has already been fixed in the `main` branch. To release the coins, launch the wallet from `main`, and then run the [release_coins](/dao-cli#release_coins) command. +Because of this anomaly, a vote for a proposal to change the DAO's settings could affect any of the DAO's other active proposals. Therefore, members are strongly encouraged to examine all open proposals when deciding whether to vote for a proposal to change the DAO's settings. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md index 97b4722a9a..dee976c9f3 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md @@ -86,7 +86,7 @@ Functionality: Configure a store for uploading Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :-------------------------- | +|:--------- |:------ |:-------- |:--------------------------- | | store_id | STRING | True | The store ID, in hex format | Response: `{"handle_upload": [true|false]}` @@ -100,7 +100,7 @@ Functionality: Configure a store for downloading from a mirror Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :------------------------------------- | +|:--------- |:------ |:-------- |:-------------------------------------- | | store_id | STRING | True | The store ID, in hex format | | url | STRING | True | The URL of the mirror to download from | @@ -118,11 +118,11 @@ Functionality: Upload data to a store Request Parameters: -| Parameter | Type | Required | Description | -| :----------------- | :----- | :------- | :-------------------------- | -| store_id | STRING | True | The store ID, in hex format | +| Parameter | Type | Required | Description | +|:-------------------- |:------ |:-------- |:--------------------------- | +| store_id | STRING | True | The store ID, in hex format | | full_tree_filename | STRING | True | Name of full tree dat file | -| diff_filename | STRING | True | Name of delta dat file | +| diff_filename | STRING | True | Name of delta dat file | Response: `{"uploaded": [true|false]}` @@ -139,7 +139,7 @@ Functionality: Download a data file from a URI Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :------------------------------------------------- | +|:--------- |:------ |:-------- |:-------------------------------------------------- | | url | STRING | True | The URI for the download, eg `"server_info.url"` | | filename | STRING | True | The name of the file to download, eg `"file1.dat"` | @@ -158,7 +158,7 @@ Functionality: Add missing files to a store Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------------------------------------------------- | +|:--------- |:------ |:-------- |:------------------------------------------------------------------------ | | store_id | STRING | True | The store ID, in hex format | | files | LIST | True | The list of files to be added, for example: `["file1.dat", "file2.dat"]` | @@ -233,10 +233,10 @@ Functionality: Add a new store Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :---------------------------------------------------------------------------------------------------------- | +|:--------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------------- | | store_id | STRING | True | The store ID, in hex format | -| bucket | STRING | True\* | The name of the S3 bucket [* Either `bucket` or `urls` or both is required] | -| urls | LIST | True\* | A list of s3 URLs, for example `["s3://one", "s3://two"]` [* Either `bucket` or `urls` or both is required] | +| bucket | STRING | True\* | The name of the S3 bucket [* Either `bucket` or `urls` or both is required] | +| urls | LIST | True\* | A list of s3 URLs, for example `["s3://one", "s3://two"]` [* Either `bucket` or `urls` or both is required] | Success Response: `{"success": true, "id": store id}` @@ -255,7 +255,7 @@ Functionality: Remove a store Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :-------------------------- | +|:--------- |:------ |:-------- |:--------------------------- | | store_id | STRING | True | The store ID, in hex format | Response: `{"success": [true|false], "store_id":store id in hex if successful}` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md index 6dc7a58906..b9e07116b5 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md @@ -221,7 +221,7 @@ sudo pfctl -sr | grep 8575 ::: -3. (optional) If you are going to use a DataLayer as a Service (DLaaS) plugin, you can add custom headers to `~/.chia/mainnet/config/config.yaml`. For example, you might update the config as follows: +3. (optional) If you are going to use a DataLayer as a Service (DLaaS) plugin, you can add custom headers to `~/.chia/mainnet/config/config.yaml`. For example, you might update the config as follows: For example, you might update the config as follows: ```yaml data_layer: @@ -278,7 +278,7 @@ Regardless of the status of `FULL NODE`, you may safely proceed with this tutori - Green dot = full node is synced - `FULL NODE` is missing = you are running in `Wallet Mode` -::: +:::
Synced wallet diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md index 0286378474..a31ce82828 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md @@ -105,6 +105,7 @@ python -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate +``` ./venv/bin/activate ``` @@ -113,6 +114,7 @@ python3 -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate +``` ./venv/bin/activate ``` @@ -139,14 +141,11 @@ chia configure --testnet true ``` :::note -If you previously had been running Chia on mainnet, then your peers table will be populated with mainnet peers. -When you switch to running on the testnet, the peers listed in this table will time out. -Eventually the table will be repopulated with testnet peers, but this can take a long time. -In order to expedite this process, We recommend that you delete your peers tables: +If you previously had been running Chia on mainnet, then your peers table will be populated with mainnet peers. When you switch to running on the testnet, the peers listed in this table will time out. Eventually the table will be repopulated with testnet peers, but this can take a long time. In order to expedite this process, We recommend that you delete your peers tables: - `~/.chia/mainnet/db/peers.dat` - `~/.chia/mainnet/wallet/db/wallet_peers.dat` - ::: +::: 2. We recommend that you use `INFO` level logging instead of the default `WARNING` level. To do this, run: @@ -185,7 +184,7 @@ Showing all public and private keys Fingerprint: 3049838316 (...) - Mnemonic seed (24 secret words): + Mnemonic seed (24 secret words): youth stomach social aware clay pottery benefit asthma mail cry rubber panda wife around provide atom cute sand staff exotic pink east gloom minute ``` @@ -199,7 +198,7 @@ If you ever need to display your address, run `chia keys show`. This command wil 6. In order to continue, you will need to have some TXCH in your wallet. If your total balance is 0, you can obtain 1 TXCH from our faucet. Copy the value of "First wallet address:" from the output of the `chia keys show` command. It will be a long string beginning with "txch". -Open our [testnet faucet page](https://testnet11-faucet.chia.net "Chia's testnet11 faucet link"). Paste your address and click "Submit". +Open our [testnet faucet page](https://testnet10-faucet.chia.net "Chia's testnet10 faucet link"). Paste your address and click "Submit". Paste your address and click "Submit". You will receive this message: `Accepted. Your request is in the queue and will be processed in the order it was received.` At some point you will receive 1 TXCH. Depending on how busy the faucet and the testnet are, this could take several minutes. However, you don't need to wait for your coins to arrive before continuing. @@ -209,12 +208,12 @@ You will receive this message: `Accepted. Your request is in the queue and will mkdir ~/.chia/mainnet/db ``` -8. If you downloaded a copy of the testnet database, you will need to wait for the download to complete before continuing. After the download has completed, use an archive manager such as [7-Zip](https://www.7-zip.org/ "7-Zip's website") to extract the file. You should now have a file in your Downloads folder called `blockchain_v2_testnet11.sqlite`. +8. If you downloaded a copy of the testnet database, you will need to wait for the download to complete before continuing. After the download has completed, use an archive manager such as [7-Zip](https://www.7-zip.org/ "7-Zip's website") to extract the file. If you downloaded a copy of the testnet database, you will need to wait for the download to complete before continuing. After the download has completed, use an archive manager such as [7-Zip](https://www.7-zip.org/ "7-Zip's website") to extract the file. You should now have a file in your Downloads folder called `blockchain_v2_testnet10.sqlite`. Move the database to the folder you just created: ```bash -mv ~/Downloads/blockchain_v2_testnet11.sqlite ~/.chia/mainnet/db +mv ~/Downloads/blockchain_v2_testnet10.sqlite ~/.chia/mainnet/db ``` 9. Start the full node, which will begin syncing to the database file: @@ -235,9 +234,9 @@ chia show -s Eventually, it will say `Full Node Synced`: ```text -Network: testnet11 Port: 58444 RPC Port: 8555 +Network: testnet10 Port: 58444 RPC Port: 8555 Node ID: 82a73b06b3a5f9493a3ac4e3d903026b39c85b748158ba41c623d531947f2a2a -Genesis Challenge: 37a90eb5185a9c4439a91ddc98bbadce7b4feba060d50116a067de66bf236615 +Genesis Challenge: ae83525ba8d1dd3f09b277de18ca3e43fc0af20d20c4b3e92ef2a48bd291ccb2 Current Blockchain Status: Full Node Synced ``` @@ -506,7 +505,7 @@ chianft submit-spend-bundles -m 10 -o 100 output.pkl Each time a spend bundle is submitted, some status info will appear. For example: ```bash -SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s +SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s ``` Expect the total time for each spend bundle to be around 1-2 minutes. A project with `10 000` NFTs could take anywhere from 7-14 hours to complete. @@ -600,7 +599,7 @@ This can be safely ignored. 4. Submit the spend bundles created in the output file (output.pkl in this example). This command has two flags: - `-m`: an optional transaction fee, in mojos. This is a fee to be used for inclusion in the blockchain, completely separate from the royalty percentage. This fee will be applied once per spend bundle of 25 NFTs. The bulk mint tool will not verify that you have enough money to cover this fee beforehand - - `-o`: _Not set._ In this example, we don't provide this option as we will be air-dropping them to their targeted address in the `metadata.csv`. We declared these spend bundles to include a targeted address in the previous command. We would not be able to create offers for NFTs where we are offering the NFT if we are not the owner. (The air-drop address is the NFT owner.) + - `-o`: _Not set._ In this example, we don't provide this option as we will be air-dropping them to their targeted address in the `metadata.csv`. We declared these spend bundles to include a targeted address in the previous command. We would not be able to create offers for NFTs where we are offering the NFT if we are not the owner. (The air-drop address is the NFT owner.) We declared these spend bundles to include a targeted address in the previous command. We would not be able to create offers for NFTs where we are offering the NFT if we are not the owner. (The air-drop address is the NFT owner.) ```bash chianft submit-spend-bundles -m 10 output.pkl @@ -609,7 +608,7 @@ chianft submit-spend-bundles -m 10 output.pkl Each time a spend bundle is submitted, some status info will appear. For example: ```bash -SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s +SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s ``` Expect the total time for each spend bundle to be around 1-2 minutes. A project with `10 000` NFTs could take anywhere from 7-14 hours to complete. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md index e733cc855a..bfa66bf165 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md @@ -63,7 +63,7 @@ The cost for minting and modifying NFTs is significantly higher. The following c If the mempool is not full, then a 1-mojo fee will be sufficient for any of these spends to be included in the next transaction block. To view the current status of the mempool, see the [Mempool Cost](https://dashboard.chia.net/d/46EAA05E/mempool-transactions-and-fees?orgId=1&viewPanel=40) table on our dashboard site. (If the green line representing the current mempool cost is close to the red line representing the maximum cost, then the mempool is full, and the following table should be used.) | Operation | Cost (approx) | Min fee (mojos) | Cost in USD at $30/XCH | -| :------------------------------ | ------------: | :-------------- | :--------------------- | +|:------------------------------- | -------------:|:--------------- |:---------------------- | | Minting NFT without DID | 53 million | 265 million | $0.00795 | | Minting NFT with DID | 123 million | 615 million | $0.01845 | | Adding a URI to NFT without DID | 41 million | 205 million | $0.00615 | @@ -126,6 +126,8 @@ values={[ Be sure to replace `` and `` with the actual folder names. +` with the actual folder names. + ```bash Set-Alias -Name chia "C:\Users\\AppData\Local\chia-blockchain\app-\resources\app.asar.unpacked\daemon\chia.exe" ``` @@ -148,7 +150,7 @@ To install Chia from source, follow our [installation guide](https://docs.chia.n ### Switching to testnet -By default, Chia will run on mainnet. To switch to the testnet (recommended) for this guide, see [our testnet instructions](https://docs.chia.net/testnets). +By default, Chia will run on mainnet. By default, Chia will run on mainnet. To switch to the testnet (recommended) for this guide, see [our testnet instructions](https://docs.chia.net/testnets). ## Configuration @@ -243,7 +245,7 @@ Chia Wallet: In order to continue, you'll need to have some TXCH in your wallet. If your total balance is 0, you can obtain 1 TXCH from our faucet. Copy the value of "First wallet address:" from the output of the `chia keys show` command. It will be a long string beginning with "txch". -Open our [testnet faucet page](https://testnet10-faucet.chia.net "Chia's testnet10 faucet link"). Paste your address and click "Submit". +Open our [testnet faucet page](https://testnet10-faucet.chia.net "Chia's testnet10 faucet link"). Paste your address and click "Submit". Paste your address and click "Submit". You'll receive this message: `Accepted. Your request is in the queue and will be processed in the order it was received.` At some point you'll receive 1 TXCH. Depending on how busy the faucet and the testnet are, this could take several minutes. However, you don't need to wait for your coins to arrive before continuing. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/observer-wallet-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/observer-wallet-guide.md new file mode 100644 index 0000000000..8a98cff94c --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/observer-wallet-guide.md @@ -0,0 +1,112 @@ +--- +slug: /guides/observer-wallet-guide +title: Observer Wallet Guide +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +## Intro + +### About + +An observer wallet is a wallet that cannot be used for sending transactions. In other words, it is a read-only wallet. This is a powerful concept for HODLers and farmers alike. + +:::info + +Currently, you need to understand how to use a command line interface (CLI) in order to set up an observer wallet. Eventually, we will make this setup easier for GUI users. + +::: + +Until the introduction of observer wallets, the Chia reference wallet always stored each public/private key pair locally. It was possible to maintain an offline key, for example in order to receive farmer rewards, but checking the balance required using a blockchain explorer. However, as a privacy feature, Chia wallets generate a new address each time they receive money. A blockchain explorer is therefore not always able to provide an accurate view of a wallet's history. + +With an observer wallet, you can view your wallet's history and balance without the risk of funds being stolen by someone who gains access to your computer. + +### Current Status + +The concept of an observer wallet was first introduced to Chia's reference wallet in version 2.4.0. In this version, it is possible to create an observer wallet from a command line, and use it with the GUI. The user experience will improve as more features get added, but for now the core functionality is in place. + +Eventually, we will add the ability to sign transactions using an external signer. + +## Set up + +This guide assumes you have a wallet set up in non-observer mode, and that you want to set up the same wallet in observer mode on a new computer where Chia is also installed. + +The first step is to obtain the wallet's master public key from the original computer. Open a command prompt or terminal window, and enter the following: + +```bash +chia keys show +``` + +Locate your wallet's fingerprint. You will see something like the following: + +```bash +Showing all public keys derived from your master key: + +Label: Testnet11 Small +Fingerprint: +Master public key (m): +Farmer public key (m/12381/8444/0/0): +Pool public key (m/12381/8444/1/0): +First wallet address:
+``` + +Save a copy of the key shown with `Master public key (m):` in a text file. This file must only contain the public key, and it must be on a single line. Copy this file to the computer on which you want to load the wallet in observer mode. + +From your second computer, run the following command to add your wallet in observer mode: + +```bash +chia keys add -f -l "" +``` + +Be sure to enter the actual file path, as well as whatever name you want to call your observer wallet. The output will look something like the following: + +```bash +Added public key with fingerprint +``` + +You may also see a warning such as the following, which can be safely ignored: + +```bash +WARNING: using a farmer address which we might not have the private keys for. We searched the first 50 addresses. Consider overriding with +WARNING: using a pool address which we might not have the private keys for. We searched the first 50 addresses. Consider overriding with +``` + +Your observer wallet has been added. + +## Usage + +If your observer wallet is not immediately displayed in the GUI, click `View` --> `Reload`, and it should appear: + +

+ observer wallet +

+
+ +Your observer wallet should now be displayed. It might have a different icon than the original wallet. Click this wallet to view it: + +

+ observer wallet +

+
+ +You can now send funds to this wallet, and its balance will be updated, just like a non-observer wallet's balance. You can even redirect your farming rewards to this wallet: + +

+ observer wallet +

+
+ +By definition, observer wallets are read-only. To test this, you can try sending funds to another wallet: + +

+ observer wallet +

+
+ +This should result in an error: + +

+ observer wallet +

+
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/seeder-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/seeder-user-guide.md index 1ed4b401ac..a4c14c8a9b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/seeder-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/seeder-user-guide.md @@ -5,15 +5,15 @@ slug: /guides/seeder-user-guide # Seeder User Guide -The Chia Seeder & Crawler is a tool to keep track of the most reliable nodes on the Chia network. Each instance of the Chia Seeder maintains its own separate list of IP addresses of these nodes. +The Chia Seeder & Crawler is a tool to keep track of the most reliable nodes on the Chia network. Each instance of the Chia Seeder maintains its own separate list of IP addresses of these nodes. Each instance of the Chia Seeder maintains its own separate list of IP addresses of these nodes. -It does so by crawling through the network, periodically revisiting known nodes from its list. If a node is either no longer available, or has exhibited untoward behavior, the Chia Seeder instance removes that node from its list. +It does so by crawling through the network, periodically revisiting known nodes from its list. It does so by crawling through the network, periodically revisiting known nodes from its list. If a node is either no longer available, or has exhibited untoward behavior, the Chia Seeder instance removes that node from its list. -The Chia Seeder runs a mini-DNS server. Anyone can obtain an entry point into Chia’s decentralized and permissionless network via a simple DNS request for reliable node IPs. +The Chia Seeder runs a mini-DNS server. The Chia Seeder runs a mini-DNS server. Anyone can obtain an entry point into Chia’s decentralized and permissionless network via a simple DNS request for reliable node IPs. -The Chia Seeder has very low memory and CPU requirements. +The Chia Seeder has very low memory and CPU requirements. It runs a faux full_node process and does not need its own node. -Chia’s core developers have already been running an instance of the Chia Seeder for some time. You can view the current status of this instance by running: +Chia’s core developers have already been running an instance of the Chia Seeder for some time. You can view the current status of this instance by running: You can view the current status of this instance by running: ```bash # IPv4 @@ -33,7 +33,7 @@ Features: ## Expectations for Chia Seeder operators -The Chia network core developers endeavor to minimize the level of trust in the DNS servers associated with a Chia Seeder. In this regard, it is expected for each Chia Seeder to be run by an individual or organization recognized as well-intentioned within the Chia community. +The Chia network core developers endeavor to minimize the level of trust in the DNS servers associated with a Chia Seeder. In this regard, it is expected for each Chia Seeder to be run by an individual or organization recognized as well-intentioned within the Chia community. In this regard, it is expected for each Chia Seeder to be run by an individual or organization recognized as well-intentioned within the Chia community. This entails following good host security practices, maintaining control of the underlying infrastructure, and not transferring control of the Chia Seeder they operate. @@ -50,6 +50,7 @@ There are additional operation considerations for inclusion in the `initial-conf ```bash $ sh install.sh $ . ./activate +$ chia init ./activate $ chia init ``` @@ -57,11 +58,11 @@ You most certainly will want to specify your own configuration of a domain name ## Special instructions on Ubuntu -On Ubuntu, it is possible that systemd-resolved already binds port 53. The Chia Seeder's built-in DNS server is run on the same port, and systemd-resolved takes precedence by default. +On Ubuntu, it is possible that systemd-resolved already binds port 53. On Ubuntu, it is possible that systemd-resolved already binds port 53. The Chia Seeder's built-in DNS server is run on the same port, and systemd-resolved takes precedence by default. Special instructions to free port 53 are provided here (points #2 and #3): https://github.com/team-exor/generic-seeder#exclamation-special-instructions-for-ubuntu-users-exclamation -This amounts to editing `/etc/systemd/resolved.conf` so as to disable binding of systemd-resolved to port 53 by setting `DNSStubListener=no`, or, alternatively, entirely disabling the systemd-resolved service. Note that you will likely need to add a nameserver in '/etc/resolv.conf'. +This amounts to editing `/etc/systemd/resolved.conf` so as to disable binding of systemd-resolved to port 53 by setting `DNSStubListener=no`, or, alternatively, entirely disabling the systemd-resolved service. Note that you will likely need to add a nameserver in '/etc/resolv.conf'. Note that you will likely need to add a nameserver in '/etc/resolv.conf'. ```bash # Example resolv.conf @@ -88,12 +89,14 @@ For a local DNS server setup, you will need control of a top-level domain (TLD) :::note Note that while it may be possible to use an existing domain, it is recommended to register a new domain name to specifically run the Chia Seeder address. ::: +::: -Proceed by logging into your domain registrar and navigating to the section pertaining to managing DNS records for your domain. Next, click or activate the button or mechanism for creating a new DNS record. Finally, create new type "A" and "AAAA" DNS record(s) for `vps.example.com`, which point at the ipv4 and ipv6 address(s) of the server running the seeder along with another new DNS record of type "NS" at `my-chia-seeder.example.com` with the nameserver set to the servers hostname, `vps.example.com`. +Proceed by logging into your domain registrar and navigating to the section pertaining to managing DNS records for your domain. Next, click or activate the button or mechanism for creating a new DNS record. Proceed by logging into your domain registrar and navigating to the section pertaining to managing DNS records for your domain. Next, click or activate the button or mechanism for creating a new DNS record. Finally, create new type "A" and "AAAA" DNS record(s) for `vps.example.com`, which point at the ipv4 and ipv6 address(s) of the server running the seeder along with another new DNS record of type "NS" at `my-chia-seeder.example.com` with the nameserver set to the servers hostname, `vps.example.com`. :::note Note that these names are examples, and as long as the "NS" record points at the hostname of the server, the seeder will work. ::: +::: You can check that this is the case by running the following command (please ensure that you have `dig` on your system by installing the `dnsutils` or `bind9-dnsutils` package; for instance, on Ubuntu, `$ sudo apt install dnsutils` or `$ sudo apt install bind9-dnsutils`): @@ -110,21 +113,21 @@ my-chia-seeder.example.com. 86400 IN NS vps.example.com For another example on how to set-up "A" and "NS" records for your domain using DigitalOcean, please refer to the following video, from 9:40 onward: https://www.youtube.com/watch?v=DsaxbwwVEXk&t=580s -For AWS Route 53 - in the hosted zone you want to use e.g. `example.com` add a "NS"/nameserver record with the `Record name` of `my-chia-seeder` and a value of `vps.example.com`. As of January 2023, the Route 53 web user interface requires you first enter text into the `Record name` field as the Record type of MX will otherwise be greyed out in the pulldown. Then you will create both an A and a AAAA record for `vps.example.com` that corresponds to your vps's IP addresses. +For AWS Route 53 - in the hosted zone you want to use e.g. `example.com` add a "NS"/nameserver record with the `Record name` of `my-chia-seeder` and a value of `vps.example.com`. As of January 2023, the Route 53 web user interface requires you first enter text into the `Record name` field as the Record type of MX will otherwise be greyed out in the pulldown. Then you will create both an A and a AAAA record for `vps.example.com` that corresponds to your vps's IP addresses. As of January 2023, the Route 53 web user interface requires you first enter text into the `Record name` field as the Record type of MX will otherwise be greyed out in the pulldown. Then you will create both an A and a AAAA record for `vps.example.com` that corresponds to your vps's IP addresses. -In `config.yaml` the `domain_name` is `my-chia-seeder.example.com.` and the `nameserver` is `vps.example.com.`. Note the trailing periods. The main thing to change in `soa` is adding a correct contact email in `rname` and optionally changing the `serial_number`. +In `config.yaml` the `domain_name` is `my-chia-seeder.example.com.` and the `nameserver` is `vps.example.com.`. Note the trailing periods. The main thing to change in `soa` is adding a correct contact email in `rname` and optionally changing the `serial_number`. Note the trailing periods. The main thing to change in `soa` is adding a correct contact email in `rname` and optionally changing the `serial_number`. ## Running ```bash -$ . ./activate +$ . $ . ./activate $ chia start seeder ``` will run both a crawler and a DNS server. Alternatively, ```bash -$ . ./activate +$ . $ . ./activate $ chia start crawler ``` @@ -145,12 +148,12 @@ If you tail the logs as you start up the node you should see the node connect an 2023-01-14T15:19:31.010 full_node chia.full_node.full_node: INFO Received 32 peers from DNS seeder, using rdtype = AAAA. ``` -Sometimes dns takes a moment so seeing some initial flakiness here is not cause for concern. Just stop again, delete `peers.dat` and try the test again. +Sometimes dns takes a moment so seeing some initial flakiness here is not cause for concern. Sometimes dns takes a moment so seeing some initial flakiness here is not cause for concern. Just stop again, delete `peers.dat` and try the test again. ## Stopping ```bash -$ . ./activate +$ . $ . ./activate $ chia stop -d all ``` @@ -158,12 +161,12 @@ $ chia stop -d all There are a couple of criteria we all look for when adding a seeder to the initial config file. -You must have an ICANN registered domain name. Your seeder host must support IPv6 and IPv4. +You must have an ICANN registered domain name. You must have an ICANN registered domain name. Your seeder host must support IPv6 and IPv4. -We ask that you commit to a monthly uptime of 99.9% which is available enough to be reliable but also leaves flexibility to not need to run a cluster and gives you time for a reboot once in a while to keep up with things like security patches. We will be monitoring all of the seeders listed in the most recent version of `initial-config.yaml`. We highly recommend that you enable monitoring of your seeder as well. We are heavy users of [Uptime Robot](https://uptimerobot.com/) but anything similar will do. +We ask that you commit to a monthly uptime of 99.9% which is available enough to be reliable but also leaves flexibility to not need to run a cluster and gives you time for a reboot once in a while to keep up with things like security patches. We will be monitoring all of the seeders listed in the most recent version of `initial-config.yaml`. We highly recommend that you enable monitoring of your seeder as well. We are heavy users of [Uptime Robot](https://uptimerobot.com/) but anything similar will do. We will be monitoring all of the seeders listed in the most recent version of `initial-config.yaml`. We highly recommend that you enable monitoring of your seeder as well. We are heavy users of [Uptime Robot](https://uptimerobot.com/) but anything similar will do. -Being a known community member - the better you're known (pseudonymously is fine) - the more likely you are to be added. You should have an account on [Keybase](https://keybase.io/) and we will need to know your Keybase handle, as you will be added to a seeder operator's private channel. +Being a known community member - the better you're known (pseudonymously is fine) - the more likely you are to be added. Being a known community member - the better you're known (pseudonymously is fine) - the more likely you are to be added. You should have an account on [Keybase](https://keybase.io/) and we will need to know your Keybase handle, as you will be added to a seeder operator's private channel. -The final criteria is geographical dispersion. If you are hosting in a region where we don't have a seeder, you are more likely to be added. We will want to know what country (and region if it's a large country e.g. North West US) - generally - your seeder will reside in to facilitate this. +The final criteria is geographical dispersion. The final criteria is geographical dispersion. If you are hosting in a region where we don't have a seeder, you are more likely to be added. We will want to know what country (and region if it's a large country e.g. North West US) - generally - your seeder will reside in to facilitate this. We will want to know what country (and region if it's a large country e.g. North West US) - generally - your seeder will reside in to facilitate this. The easiest way to propose being added is to open a pull request for [initial-config.yaml](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/util/initial-config.yaml) and include the information required from the four points above. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/simulator-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/simulator-user-guide.md index 10f52faeef..db6aa5a210 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/simulator-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/simulator-user-guide.md @@ -12,7 +12,7 @@ This document will guide you through the process of setting up Chia's Simulator. - [Simulator CLI Reference](/simulator-cli) :::note -It is possible to run the simulator and either Chia's testnet or mainnet simultaneously. This is because the simulator will use its own ports and directories. +It is possible to run the simulator and either Chia's testnet or mainnet simultaneously. This is because the simulator will use its own ports and directories. ::: This is because the simulator will use its own ports and directories. ::: --- @@ -24,7 +24,7 @@ The simulator is included in the `chia-blockchain` GitHub repository (the same r After you have installed from source and have activated your virtual environment (you should see `(venv)` on the left side of your command prompt), you are all set to install the simulator. :::warning -If you installed Chia from the binary installation file, you cannot use this installation to run the simulator. Instead, follow the instructions linked above to create a new installation from source, then return to this guide. +If you installed Chia from the binary installation file, you cannot use this installation to run the simulator. Instead, follow the instructions linked above to create a new installation from source, then return to this guide. ::: Instead, follow the instructions linked above to create a new installation from source, then return to this guide. ::: ## Setup instructions @@ -89,7 +89,7 @@ Make sure your CHIA_ROOT Environment Variable is set to: C:\Users\\.chia\s ### Configure the environment -Now that you have created the simulator, you can set the `CHIA_ROOT` environment variable to point to the simulator's installation directory. This will enable you to run the simulator from outside of `chia-blockchain`: +Now that you have created the simulator, you can set the `CHIA_ROOT` environment variable to point to the simulator's installation directory. This will enable you to run the simulator from outside of `chia-blockchain`: This will enable you to run the simulator from outside of `chia-blockchain`: :::note -By setting the `CHIA_ROOT` path to the simulator in the current shell window (rather than globally), this enables you to run the simulator in tandem with a full node running on either the testnet or on mainnet. This is because the simulator uses different ports than a normal full node. +By setting the `CHIA_ROOT` path to the simulator in the current shell window (rather than globally), this enables you to run the simulator in tandem with a full node running on either the testnet or on mainnet. This is because the simulator uses different ports than a normal full node. ::: This is because the simulator uses different ports than a normal full node. ::: ## Usage instructions @@ -137,6 +137,7 @@ This command is the equivalent of `chia start node` on testnet and mainnet. :::note You will need to have your `CHIA_ROOT` set before using this command, otherwise it will try to connect to your mainnet or testnet node. ::: +::: Run the following command to start the wallet: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/custom-puzzle-lock.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/custom-puzzle-lock.md index 6aea346065..dfcf04b844 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/custom-puzzle-lock.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/custom-puzzle-lock.md @@ -98,7 +98,7 @@ A solution to this puzzle then needs to contain the compiled puzzle we want to h **Example solution for the password-locked coin:** ```chialisp -((a (q 2 (i (= (sha256 5) (q . 0x2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824)) (q 4 (c 2 (c 11 (c 23 ()))) ()) (q 8)) 1) (c (q . 51) 1))) +((a (q 2 (i (= (sha256 5) (q . 0x2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824)) (q 4 (c 2 (c 11 (c 23 ()))) ()) (q 8)) 1) (c (q . 51) 1))) 0x2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824)) (q 4 (c 2 (c 11 (c 23 ()))) ()) (q 8)) 1) (c (q . 51) 1))) ``` The resulting hash for this example puzzle is again `0x4843c869bba5f65aa1e806cd372dae5668ca3b69640d067e86837ca96b324e71`. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-cli.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-cli.md index 90ac9a7c8c..4237631503 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-cli.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-cli.md @@ -381,7 +381,7 @@ Wallet ID 4 type COLOURED_COIN CAT King Cole (Asset ID: 1121996b75cce3c746369ace ## Create an expiring Offer (RPC) -In this example, we will offer 0.1 CATs (`Launcher ID: 91aa...004r`) in exchange for 1 TXCH (`Wallet ID: 1`). In addition, we will add an expiry timestamp so that this Offer will expire on Jan. 1, 2024. This is accomplished with the `max_time` flag: +In this example, we will offer 0.1 CATs (`Launcher ID: 91aa...004r`) in exchange for 1 TXCH (`Wallet ID: 1`). In addition, we will add an expiry timestamp so that this Offer will expire on Jan. 1, 2024: In addition, we will add an expiry timestamp so that this Offer will expire on Jan. 1, 2024. This is accomplished with the `max_time` flag: ```bash chia rpc wallet create_offer_for_ids '{"offer":{"1":1000000000000,"91aa49303fd325cf8029cc0ee5e19ac78ec33d641d63b50d0ba859309a73004d":-100},"fee":10000000,"driver_dict":{},"validate_only":false, "max_time": 1704070800}' diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-gui.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-gui.md index 0b4a7f18b5..ddb08929f7 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-gui.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/tutorials/offers-gui.md @@ -1,5 +1,5 @@ --- -slug: /guides/offers-gui-tutorial-old +slug: /guides/offers-gui-tutorial title: Offers - GUI --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/verifiable-credentials-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/verifiable-credentials-guide.md index 93d8188a35..345e26fb80 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/verifiable-credentials-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/verifiable-credentials-guide.md @@ -20,18 +20,18 @@ For additional resources, see the following: :::warning -The commands in this guide are only examples. Be sure to replace the listed values with values from your local system. +The commands in this guide are only examples. The commands in this guide are only examples. Be sure to replace the listed values with values from your local system. -This guide was creating using testnet10. The example commands use a fee of 100 million mojos, which will be rather high for mainnet usage. If running on mainnet, be sure to adjust your fees accordingly. +This guide was creating using testnet11. This guide was creating using testnet10. The example commands use a fee of 100 million mojos, which will be rather high for mainnet usage. If running on mainnet, be sure to adjust your fees accordingly. If running on mainnet, be sure to adjust your fees accordingly. ::: ## Definitions - **Decentralized Identifier (DID)** -- A decentralized way to represent an identity of an organization, a person, or any other entity -- **Verifiable Credential (VC)** -- Allows someone or something to prove that a subject belongs to a certain category or categories, such as being a US citizen. One type of VC is issued by a Know Your Customer (KYC) provider, who must perform this verification. +- **Verifiable Credential (VC)** -- Allows someone or something to prove that a subject belongs to a certain category or categories, such as being a US citizen. One type of VC is issued by a Know Your Customer (KYC) provider, who must perform this verification. One type of VC is issued by a Know Your Customer (KYC) provider, who must perform this verification. - In Chia terminology, VCs depend on DIDs. In other words, a DID is required in order to mint a VC on Chia's blockchain. + In Chia terminology, VCs depend on DIDs. In Chia terminology, VCs depend on DIDs. In other words, a DID is required in order to mint a VC on Chia's blockchain. - **Proofs** -- Key-value pairs that are attached to a VC @@ -46,11 +46,11 @@ In order to mint a VC, you will need to have: - One mojo to create a VC singleton - Sufficient funds to cover blockchain fees, the amount of which depend on how busy the blockchain is at any moment -You are recommended to test minting VCs on the testnet prior to minting them on mainnet. If you are unsure of how to configure your wallet to use the testnet, see our [guide](https://docs.chia.net/guides/chialisp-testnet-setup). +You are recommended to test minting VCs on the testnet prior to minting them on mainnet. You are recommended to test minting VCs on the testnet prior to minting them on mainnet. If you are unsure of how to configure your wallet to use the testnet, see our [guide](https://docs.chia.net/guides/chialisp-testnet-setup). We also have faucets available if you don't have sufficient funds to get started: -- [testnet](https://testnet10-faucet.chia.net/) +- [testnet](https://testnet11-faucet.chia.net/) - [mainnet](https://faucet.chia.net/) ### Entities Involved @@ -60,7 +60,7 @@ VC issuance and usage involves at least two entities: 1. Credential subject / holder -- the individual or entity who has applied for a VC (aka the _subject_) or currently holds a VC (aka the _holder_) 2. Proof provider / credential issuer -- the entity that creates and signs the VC, thus asserting the claims about the holder's identity, attributes, or qualifications, and provides a proof for those claims in a credential that is issued to the holder -To test issuing, minting, and revoking VCs, you will need to create separate wallets to represent both of these entities. The two wallets can coexist on the same computer. +To test issuing, minting, and revoking VCs, you will need to create separate wallets to represent both of these entities. The two wallets can coexist on the same computer. The two wallets can coexist on the same computer. :::info note @@ -74,20 +74,20 @@ For this guide, the Verifier is the blockchain itself. ### DID Creation -The proof provider **must** have a DID in order to mint a VC. In order to create a DID, run the following command from a terminal window or command prompt: +The proof provider **must** have a DID in order to mint a VC. The proof provider **must** have a DID in order to mint a VC. In order to create a DID, run the following command from a terminal window or command prompt: ```bash chia wallet did create -m 0.0001 ``` -The response will include the ID of the newly created DID (it will begin with `did:chia:`). Save your local DID ID for later (it will be different from the one displayed here): +The response will include the ID of the newly created DID (it will begin with `did:chia:`). Save your local DID ID for later (it will be different from the one displayed here): Save your local DID ID for later (it will be different from the one displayed here): ```bash Successfully created a DID wallet with name None and id 2 on key 1725104286 Successfully created a DID did:chia:1rnvmwp3wmglslk942mwsrmf7dlkluytyna8mgewel44h4ne3nd9slhtddg in the newly created DID wallet ``` -The DID will be created with an on-chain transaction. After this transaction has been confirmed, you can view your DID by running `chia wallet show`: +The DID will be created with an on-chain transaction. The DID will be created with an on-chain transaction. After this transaction has been confirmed, you can view your DID by running `chia wallet show`: ```bash chia wallet show @@ -124,7 +124,7 @@ This section will show you how to mint, transfer, and revoke a VC using Chia's ` ### Create proofs -First, you must add proofs to the local database. To do this, run the [add_proof_reveal](/vc-cli#add_proof_reveal) command. You can add multiple proofs by reusing the `proof` parameter. For example: +First, you must add proofs to the local database. First, you must add proofs to the local database. To do this, run the [add_proof_reveal](/vc-cli#add_proof_reveal) command. You can add multiple proofs by reusing the `proof` parameter. For example: You can add multiple proofs by reusing the `proof` parameter. For example: ```bash chia wallet vcs add_proof_reveal --proof test_proof1 --proof test_proof2 @@ -152,7 +152,7 @@ Be sure to note your own root hash, as you will need it when minting a VC. :::warning important -When using the CLI to add proofs, the value of each proof will be `1`. This is not configurable in the CLI. If you need to use different values, see the [RPC guide](#rpc-guide) instead. +When using the CLI to add proofs, the value of each proof will be `1`. This is not configurable in the CLI. If you need to use different values, see the [RPC guide](#rpc-guide) instead. This is not configurable in the CLI. If you need to use different values, see the [RPC guide](#rpc-guide) instead. ::: @@ -197,9 +197,9 @@ To address: txch1wrr3hew9nr8ukenv3nwq0fg78h4uh5pm9shyqjl4rmfz9nuqcyxqcy8lth Created at: 2023-06-23 12:34:13 ``` -By default, the VC will be minted to the same wallet that runs this command. However, you can also use the `--target-address` parameter to mint the VC to a different address. +By default, the VC will be minted to the same wallet that runs this command. By default, the VC will be minted to the same wallet that runs this command. However, you can also use the `--target-address` parameter to mint the VC to a different address. -When a VC is first minted, it will not contain any proofs. You can verify this by running the `get` command: +When a VC is first minted, it will not contain any proofs. You can verify this by running the `get` command: You can verify this by running the `get` command: ```bash chia wallet vcs get @@ -215,13 +215,13 @@ Coin ID: 8942dc321387287084a92e6451a01505e6771df81daa86937679eb1ef67abb4a Inner Address: txch1wrr3hew9nr8ukenv3nwq0fg78h4uh5pm9shyqjl4rmfz9nuqcyxqcy8lth ``` -This command shows the `Launcher ID` (the VC's ID), which you will need for the next command. In addition, the `Coin ID` will be required in case the proofs need to be revoked later. +This command shows the `Launcher ID` (the VC's ID), which you will need for the next command. In addition, the `Coin ID` will be required in case the proofs need to be revoked later. In addition, the `Coin ID` will be required in case the proofs need to be revoked later. -Previously, you added your desired proofs to the local database and calculated the root hash. The next step is to add this root hash to the VC, and simultaneously send it to the new holder. This is accomplished by spending the VC. +Previously, you added your desired proofs to the local database and calculated the root hash. Previously, you added your desired proofs to the local database and calculated the root hash. The next step is to add this root hash to the VC, and simultaneously send it to the new holder. This is accomplished by spending the VC. This is accomplished by spending the VC. ### Add proofs to a VC -Use the [update_proofs](/vc-cli#update_proofs) command to add proofs to a VC. This command must be run from the proof provider's wallet (the wallet that contains the DID used for minting). +Use the [update_proofs](/vc-cli#update_proofs) command to add proofs to a VC. This command must be run from the proof provider's wallet (the wallet that contains the DID used for minting). This command must be run from the proof provider's wallet (the wallet that contains the DID used for minting). The `--new-proof-hash` parameter is required; this hash was included in the response from running the `add_proof_reveal` command. @@ -258,7 +258,7 @@ To address: txch1ehkl33dypc7mg820c7j94zfg8pz5j5lqtx7253nmxft52ryvzw8stx7czc Created at: 2023-06-23 12:48:15 ``` -After this transaction has been confirmed on the blockchain, the new **credential holder** can confirm that the proofs are included. First, the credential holder needs to run the same command as the proof provider to add the proofs to the local database. For example: +After this transaction has been confirmed on the blockchain, the new **credential holder** can confirm that the proofs are included. First, the credential holder needs to run the same command as the proof provider to add the proofs to the local database. For example: First, the credential holder needs to run the same command as the proof provider to add the proofs to the local database. For example: ```bash chia wallet vcs add_proof_reveal --proof test_proof1 --proof test_proof2 @@ -276,7 +276,7 @@ Next, the credential holder can run the [get](/vc-cli#get) command: chia wallet vcs get ``` -In this case, one VC is shown, along with the proof hash and both proofs. If the proofs were not manually added to the local database, they would not show in this command, and the GUI would show the VC as invalid. +In this case, one VC is shown, along with the proof hash and both proofs. In this case, one VC is shown, along with the proof hash and both proofs. If the proofs were not manually added to the local database, they would not show in this command, and the GUI would show the VC as invalid. ```bash Proofs: @@ -292,13 +292,13 @@ Proof Hash: f063e22557705b14425b8fca60018796b4364eb6354f45d0b99431a71d3043e5 ### Revoke a VC -Typically, the proof provider only needs to mint a VC, add proofs, and transfer the VC to the new holder. However, at some point, a holder's proofs may change. For example, a holder might have originally proven that they were not a US citizen, and then they later became a US citizen. +Typically, the proof provider only needs to mint a VC, add proofs, and transfer the VC to the new holder. However, at some point, a holder's proofs may change. For example, a holder might have originally proven that they were not a US citizen, and then they later became a US citizen. However, at some point, a holder's proofs may change. For example, a holder might have originally proven that they were not a US citizen, and then they later became a US citizen. -In cases such as this, the proof provider needs to _revoke_ the credentials, ie to remove all proofs from a VC. (The holder will continue to hold the VC, but it will no longer contain any proofs.) We don't allow the proof provider to take back the VC itself because it is possible for it to custody other assets, though we don't support this yet. +In cases such as this, the proof provider needs to _revoke_ the credentials, ie to remove all proofs from a VC. (The holder will continue to hold the VC, but it will no longer contain any proofs.) We don't allow the proof provider to take back the VC itself because it is possible for it to custody other assets, though we don't support this yet. (The holder will continue to hold the VC, but it will no longer contain any proofs.) We don't allow the proof provider to take back the VC itself because it is possible for it to custody other assets, though we don't support this yet. The only wallet that is allowed to revoke credentials is the proof provider's (the wallet that contains the DID used to mint the VC). -In order to run the [revoke](/vc-cli#revoke) command, the proof provider will need to know the parent coin ID (the `-p` parameter). Because VCs are singletons, their parent coin IDs will change every time the VC is spent (every time a change is made). +In order to run the [revoke](/vc-cli#revoke) command, the proof provider will need to know the parent coin ID (the `-p` parameter). Because VCs are singletons, their parent coin IDs will change every time the VC is spent (every time a change is made). Because VCs are singletons, their parent coin IDs will change every time the VC is spent (every time a change is made). For testing purposes, the **holder's wallet** can obtain the parent coin ID by running the [vc_get](/vc-rpc#vc_get) RPC. The parent coin ID is the value of the `"parent_coin_info"`. In a production environment, the proof provider will track the VC on-chain and obtain this info immediately prior to revoking the VC. @@ -312,22 +312,23 @@ As a result, the VC will be recreated in the same wallet, but without any proofs ```bash VC successfully revoked! +Proofs successfully updated! Relevant TX records: -Transaction 286cc31575aa167c4b34cbc0a768a162caefb6afea77560db0693934ac3fbf1e +Transaction 76f5ea8475d695e798518cd405070dc22542e31fc85220ff7d2ca7b44852a45b Status: Pending -Amount sent: 1E-12 XCH -To address: txch1ehkl33dypc7mg820c7j94zfg8pz5j5lqtx7253nmxft52ryvzw8stx7czc -Created at: 2023-06-23 13:33:50 +Amount sent: 0 XCH +To address: txch10xjm79zct87gc8ux5vzrhnnt03zjn4ntn5y95w37rsfmp4rxjycquqctuc +Created at: 2023-06-15 10:15:27 -Transaction ae6378e84742ab6abb07df666291093938ec9e06ae8e2b4066d7386d94289ba3 +Transaction f9eebb0520d024aaf4ae176d554c0f806b8d724d21d5da03b5f541fafd69c99f Status: Pending -Amount sent: 0 XCH -To address: txch1mahlm65l8q9frcqcfveekx3a29cd74w6gfajqy05ukz2afrzg03syqkz3p -Created at: 2023-06-23 13:33:50 +Amount sent: 1E-12 XCH +To address: txch1dlyh9rwd9y6clt3pjjs3gh25ck9vlfx7qwqvvru27dmhgtn80z9s2rruam +Created at: 2023-06-15 10:15:28 ``` -After these transactions have been confirmed on-chain, the VC no longer contains any proofs. The holder can verify this: +After these transactions have been confirmed on-chain, the VC no longer contains any proofs. The holder can verify this: The holder can verify this: ```bash chia wallet vcs get @@ -343,7 +344,7 @@ Proofs: ## RPC Guide -This section will show you how to mint, transfer, and revoke a VC using Chia's [wallet RPC](/vc-rpc). The RPC commands will generally give more detailed responses than their CLI equivalents, but the functionality will be mostly the same. +This section will show you how to mint, transfer, and revoke a VC using Chia's `wallet` [CLI commands](/vc-cli). A similar walk-through using RPCs will be presented in the [next section](#rpc-guide). This section will show you how to mint, transfer, and revoke a VC using Chia's [wallet RPC](/vc-rpc). The RPC commands will generally give more detailed responses than their CLI equivalents, but the functionality will be mostly the same.
Note about Windows command escaping @@ -366,7 +367,7 @@ chia rpc wallet vc_get '\"vc_id\": \"13ba084e78475327e41c60df5a108965d7a283f065b ### Create proofs -First, you must add proofs to the local database. To do this, run the [vc_add_proofs](/vc-rpc#vc_add_proofs) command. `"proofs"` is a dictionary of key-value pairs. Unlike the equivalent CLI command, this command allows you to use any string value. +First, you must add proofs to the local database. First, you must add proofs to the local database. To do this, run the [vc_add_proofs](/vc-rpc#vc_add_proofs) command. `"proofs"` is a dictionary of key-value pairs. Unlike the equivalent CLI command, this command allows you to use any string value. `"proofs"` is a dictionary of key-value pairs. Unlike the equivalent CLI command, this command allows you to use any string value. ```json chia rpc wallet vc_add_proofs '{"proofs": {"example_proof_1": "example_value_1", "example_proof_2": "example_value_2"}}' @@ -386,7 +387,7 @@ The next step is to calculate the root hash for the proofs you just added. A VC's proofs are presented as a Merkle tree, the root hash of which is stored on-chain. -When looking up proofs, a hash called a _Proof of Inclusion_ is all that is required to be presented. Any third-party observers of the blockchain won't be able to identify who the VC corresponds to, but the KYC Provider will know this information as the issuer of the VC. +When looking up proofs, a hash called a _Proof of Inclusion_ is all that is required to be presented. When looking up proofs, a hash called a _Proof of Inclusion_ is all that is required to be presented. Any third-party observers of the blockchain won't be able to identify who the VC corresponds to, but the KYC Provider will know this information as the issuer of the VC. In order to construct a Merkle tree from a set of proofs: @@ -500,7 +501,7 @@ console.log( ); ``` -The script will output the proof hash for the proofs your entered. In this example, the output is: +The script will output the proof hash for the proofs your entered. In this example, the output is: In this example, the output is: `96c9597578333c840f895f30af6d40b9f6c0d69100db1a13ae2e26e4c94acdd3` @@ -508,7 +509,7 @@ The script will output the proof hash for the proofs your entered. In this examp :::info -If you want to retrieve your original proofs from a proof hash, run the [vc_get_proofs_for_root](/vc-rpc#vc_get_proofs_for_root) command. For example: +If you want to retrieve your original proofs from a proof hash, run the [vc_get_proofs_for_root](/vc-rpc#vc_get_proofs_for_root) command. For example: For example: ```json chia rpc wallet vc_get_proofs_for_root '{"root": "96c9597578333c840f895f30af6d40b9f6c0d69100db1a13ae2e26e4c94acdd3"}' @@ -532,7 +533,7 @@ Note that this command will only succeed if you have already added the correspon ### Mint a VC -To mint a VC, run the [vc_mint](/vc-rpc#vc_mint) command. The `did_id` parameter is required. This is the DID owned by the minting wallet. You may also optionally pass in a `target_address`, where the VC will be delivered. If this parameter is missing, the VC will be sent to the same wallet that owns the DID: +To mint a VC, run the [vc_mint](/vc-rpc#vc_mint) command. The `did_id` parameter is required. This is the DID owned by the minting wallet. You may also optionally pass in a `target_address`, where the VC will be delivered. If this parameter is missing, the VC will be sent to the same wallet that owns the DID: The `did_id` parameter is required. This is the DID owned by the minting wallet. You may also optionally pass in a `target_address`, where the VC will be delivered. If this parameter is missing, the VC will be sent to the same wallet that owns the DID: ```json chia rpc wallet vc_mint '{"did_id": "did:chia:1rnvmwp3wmglslk942mwsrmf7dlkluytyna8mgewel44h4ne3nd9slhtddg", "target_address": "txch1yfcclacd6sch2w9dz394zjuq7pqnmz5g7mrqac0hjhwpzmyahe9sqetxaz", "fee": 100000000}' @@ -662,21 +663,21 @@ As a result, the spend bundle used to mint the VC will be output: } ``` -When a VC is first minted, it will not contain any proofs. +When a VC is first minted, it will not contain any proofs. You can verify this by running the `get` command: Previously, you added your desired proofs to the local database and calculated the root hash. The next step is to add your root hash to the VC. ### Add proofs to a VC -In Chia, a singleton is a primitive standard that allows a coin to be recreated with different properties when it is spent. Chia VCs are singletons; use the [vc_spend](/vc-rpc#vc_spend) command to spend a VC and recreate it with a new set of proofs. +In Chia, a singleton is a primitive standard that allows a coin to be recreated with different properties when it is spent. In Chia, a singleton is a primitive standard that allows a coin to be recreated with different properties when it is spent. Chia VCs are singletons; use the [vc_spend](/vc-rpc#vc_spend) command to spend a VC and recreate it with a new set of proofs. The `new_proof_hash` parameter is required; this is the root hash you previously obtained. -The `new_puzhash` parameter is typically used, but not required. This parameter allows you to recreate the VC singleton in a different wallet (ie to send the VC to the new holder in the same command that is used to add the proof hash). +The `new_puzhash` parameter is typically used, but not required. This parameter allows you to recreate the VC singleton in a different wallet (ie to send the VC to the new holder in the same command that is used to add the proof hash). This parameter allows you to recreate the VC singleton in a different wallet (ie to send the VC to the new holder in the same command that is used to add the proof hash). :::note -`new_puzhash` requires a _puzzle hash_ and not a wallet address. If you are not sure how to convert a wallet address to a puzzle hash, the [Chia.tt explorer](https://chia.tt/convert) includes a handy puzzle hash converter tool. If you prefer to do this conversion programmatically, use the `decode` command from the [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools) repository. +`new_puzhash` requires a _puzzle hash_ and not a wallet address. If you are not sure how to convert a wallet address to a puzzle hash, the [Chia.tt explorer](https://chia.tt/convert) includes a handy puzzle hash converter tool. If you prefer to do this conversion programmatically, use the `decode` command from the [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools) repository. If you are not sure how to convert a wallet address to a puzzle hash, the [Chia.tt explorer](https://chia.tt/convert) includes a handy puzzle hash converter tool. If you prefer to do this conversion programmatically, use the `decode` command from the [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools) repository. ::: @@ -812,7 +813,7 @@ The response includes the spend bundle used to spend the VC: } ``` -After this transaction has been confirmed on the blockchain, the new **credential holder** can confirm that the proofs are included. First, the credential holder needs to run the same command as the proof provider to add the proofs to the local database. For example: +After this transaction has been confirmed on the blockchain, the new **credential holder** can confirm that the proofs are included. First, the credential holder needs to run the same command as the proof provider to add the proofs to the local database. For example: First, the credential holder needs to run the same command as the proof provider to add the proofs to the local database. For example: ```json chia rpc wallet vc_add_proofs '{"proofs": {"example_proof_1": "example_value_1", "example_proof_2": "example_value_2"}}' @@ -915,9 +916,9 @@ Response: ### Revoke a VC -Typically, the proof provider only needs to mint a VC, add proofs, and transfer the VC to the new holder. However, at some point, a holder's proofs may change. For example, a holder might have originally proven that they were not a US citizen, and then they later became a US citizen. +Typically, the proof provider only needs to mint a VC, add proofs, and transfer the VC to the new holder. However, at some point, a holder's proofs may change. For example, a holder might have originally proven that they were not a US citizen, and then they later became a US citizen. However, at some point, a holder's proofs may change. For example, a holder might have originally proven that they were not a US citizen, and then they later became a US citizen. -In cases such as this, the proof provider needs to _revoke_ the credentials, ie to remove all proofs from a VC. (The holder will continue to hold the VC, but it will no longer contain any proofs.) We don't allow the proof provider to take back the VC itself because it is possible for it to custody other assets, though we don't support this yet. +In cases such as this, the proof provider needs to _revoke_ the credentials, ie to remove all proofs from a VC. (The holder will continue to hold the VC, but it will no longer contain any proofs.) We don't allow the proof provider to take back the VC itself because it is possible for it to custody other assets, though we don't support this yet. (The holder will continue to hold the VC, but it will no longer contain any proofs.) We don't allow the proof provider to take back the VC itself because it is possible for it to custody other assets, though we don't support this yet. The only wallet that is allowed to revoke credentials is the proof provider's (the wallet that contains the DID used to mint the VC). @@ -1083,7 +1084,7 @@ As a result, the VC will be recreated in the same wallet, but without any proofs } ``` -After these transactions have been confirmed on-chain, the VC no longer contains any proofs. The holder can verify this: +After these transactions have been confirmed on-chain, the VC no longer contains any proofs. The holder can verify this: The holder can verify this: ```json chia rpc wallet vc_get_list diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md index 53337fc203..8631fcf17f 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md @@ -18,50 +18,50 @@ For more info, see our WalletConnect [command documentation](/walletconnect-comm The following table shows each RPC for Chia WalletConnect dApps, along with a description of what each RPC does, and a link to the equivalent Chia RPC: -| WalletConnect RPC | Chia Wallet RPC | Description | -| :-------------------- | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ | -| addCATtoken | [create_new_wallet](/wallet-rpc#create_new_wallet) | Create a new wallet for CATs | -| addVCProofs | [vc_add_proofs](/vc-rpc/#vc_add_proofs) | Add a set of proofs to the DB that can be used when spending a VC | -| cancelOffer | [cancel_offer](/wallet-rpc#cancel_offer) | Cancel an offer | -| checkOfferValidity | [check_offer_validity](/wallet-rpc#check_offer_validity) | Check if an offer is valid | -| createNewDIDWallet | [create_new_wallet](/did-rpc/#create_new_wallet) | Create a new DID wallet | -| createOfferForIDs | [create_offer_for_ids](/wallet-rpc#create_offer_for_ids) | Create a new offer | -| getAllOffers | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | -| getCATAssetId | [cat_get_asset_id](/wallet-rpc#cat_get_asset_id) | Retrieve a the asset ID from a CAT wallet | -| getCATWalletInfo | [get_wallets](/wallet-rpc/#get_wallets) | Get CAT Wallet Info | +| WalletConnect RPC | Chia Wallet RPC | Description | +|:--------------------- |:-------------------------------------------------------------------- |:------------------------------------------------------------------------------------------------- | +| addCATtoken | [create_new_wallet](/wallet-rpc#create_new_wallet) | Create a new wallet for CATs | +| addVCProofs | [vc_add_proofs](/vc-rpc/#vc_add_proofs) | Add a set of proofs to the DB that can be used when spending a VC | +| cancelOffer | [cancel_offer](/wallet-rpc#cancel_offer) | Cancel an offer | +| checkOfferValidity | [check_offer_validity](/wallet-rpc#check_offer_validity) | Check if an offer is valid | +| createNewDIDWallet | [create_new_wallet](/did-rpc/#create_new_wallet) | Create a new DID wallet | +| createOfferForIDs | [create_offer_for_ids](/wallet-rpc#create_offer_for_ids) | Create a new offer | +| getAllOffers | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | +| getCATAssetId | [cat_get_asset_id](/wallet-rpc#cat_get_asset_id) | Retrieve a the asset ID from a CAT wallet | +| getCATWalletInfo | [get_wallets](/wallet-rpc/#get_wallets) | Get CAT Wallet Info | | getCurrentAddress | [get_next_address](/wallet-rpc#get_next_address)\* | Set `new_address` to `false` to use the current address | | getNextAddress | [get_next_address](/wallet-rpc#get_next_address)\* | Set `new_address` to `true` to create a new address | -| getNFTsCount | [nft_count_nfts](/nft-rpc/#nft_count_nfts) | Count the number of NFTs in a wallet | -| getNFTInfo | [nft_get_info](/nft-rpc/#nft_get_info) | Get info about an NFT | -| getNFTs | [nft_get_nfts](/nft-rpc/#nft_get_nfts) | Show all NFTs in a given wallet | +| getNFTsCount | [nft_count_nfts](/nft-rpc/#nft_count_nfts) | Count the number of NFTs in a wallet | +| getNFTInfo | [nft_get_info](/nft-rpc/#nft_get_info) | Get info about an NFT | +| getNFTs | [nft_get_nfts](/nft-rpc/#nft_get_nfts) | Show all NFTs in a given wallet | | getNFTWalletsWithDIDs | [nft_get_wallets_with_dids](/nft-rpc/#nft_get_wallets_with_dids) | Show all NFT wallets that are associated with DIDs | -| getOfferData | [get_offer](/wallet-rpc#get_offer) | Show the details of one offer | -| getOfferRecord | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | -| getOffersCount | [get_offers_count](/wallet-rpc#get_offers_count) | Obtain the number of offers from the current wallet | -| getOfferSummary | [get_offer_summary](/wallet-rpc#get_offer_summary) | Show a summary of an offer | +| getOfferData | [get_offer](/wallet-rpc#get_offer) | Show the details of one offer | +| getOfferRecord | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | +| getOffersCount | [get_offers_count](/wallet-rpc#get_offers_count) | Obtain the number of offers from the current wallet | +| getOfferSummary | [get_offer_summary](/wallet-rpc#get_offer_summary) | Show a summary of an offer | | getProofsForRoot | [vc_get_proofs_for_root](/vc-rpc/#vc_get_proofs_for_root) | Given a specified VC root, get any proofs associated with that root | -| getPublicKey | [get_public_key](/daemon-rpc#get_public_key) | Request the user to provide their master public key | -| getSyncStatus | [get_sync_status](/wallet-rpc#get_sync_status) | Show whether the current wallet is syncing or synced | -| getTransaction | [get_transaction](/wallet-rpc#get_transaction) | Get a transaction's details from its ID | -| getVC | [vc_get](/vc-rpc/#vc_get) | Given a launcher ID, get the Verifiable Credential | -| getVCList | [vc_get_list](/vc-rpc/#vc_get_list) | Get a list of Verifiable Credentials | -| getWalletAddresses | [get_wallet_addresses](/daemon-rpc/#get_wallet_addresses) | Get wallet addresses for one or more wallet keys | -| getWalletBalance | [get_wallet_balance](/wallet-rpc#get_wallet_balance) | Obtain the balance (and related info) from a wallet | -| getWalletBalances | [get_wallet_balances](/wallet-rpc/#get_wallet_balances) | Request the asset balances for specific wallets associated with the current wallet key | -| getWallets | [get_wallets](/wallet-rpc#get_wallets) | Show all wallets associated with the current fingerprint, including (by default) coin information | -| logIn | [log_in](/wallet-rpc#log_in) | Log into the wallet with the specified key | -| mintNFT | [nft_mint_nft](/nft-rpc/#nft_mint_nft) | Mint an NFT | -| revokeVC | [vc_revoke](/vc-rpc/#vc_revoke) | Revoke an on chain VC provided the correct DID is available | -| sendTransaction | [send_transaction](/wallet-rpc#send_transaction) | Send a transaction | -| setDIDName | [did_set_wallet_name](/did-rpc/#did_set_wallet_name) | Set the name of a DID wallet | -| setNFTDID | [nft_set_nft_did](/nft-rpc/#nft_set_nft_did) | Set the DID for an NFT | -| showNotification | [get_notifications](/wallet-rpc/#get_notifications) | Show notification with offer or general announcement | -| signMessageByAddress | [sign_message_by_address](/wallet-rpc#sign_message_by_address) | Sign a message using an XCH address without incurring an on-chain transaction | -| signMessageById | [sign_message_by_id](/wallet-rpc#sign_message_by_id) | Sign a message using a DID or NFT ID without incurring an on-chain transaction | -| spendCAT | [cat_spend](/wallet-rpc#cat_spend) | Send CAT funds to another wallet | -| spendClawbackCoins | [spend_clawback_coins](/wallet-rpc/#spend_clawback_coins) | Claw back or claim claw back transaction | -| takeOffer | [take_offer](/wallet-rpc#take_offer) | Take an offer | -| transferNFT | [nft_transfer_nft](/nft-rpc#nft_transfer_nft) | Transfer an NFT to a new wallet address | -| spendVC | [vc_spend](/vc-rpc/#vc_spend) | Add Proofs To Verifiable Credential | -| verifySignature | [verify_signature](/wallet-rpc#verify_signature) | Given a public key, message and signature, verify if it is valid | -| waitForConfirmation | | | +| getPublicKey | [get_public_key](/daemon-rpc#get_public_key) | Request the user to provide their master public key | +| getSyncStatus | [get_sync_status](/wallet-rpc#get_sync_status) | Show whether the current wallet is syncing or synced | +| getTransaction | [get_transaction](/wallet-rpc#get_transaction) | Get a transaction's details from its ID | +| getVC | [vc_get](/vc-rpc/#vc_get) | Given a launcher ID, get the Verifiable Credential | +| getVCList | [vc_get_list](/vc-rpc/#vc_get_list) | Get a list of Verifiable Credentials | +| getWalletAddresses | [get_wallet_addresses](/daemon-rpc/#get_wallet_addresses) | Get wallet addresses for one or more wallet keys | +| getWalletBalance | [get_wallet_balance](/wallet-rpc#get_wallet_balance) | Obtain the balance (and related info) from a wallet | +| getWalletBalances | [get_wallet_balances](/wallet-rpc/#get_wallet_balances) | Request the asset balances for specific wallets associated with the current wallet key | +| getWallets | [get_wallets](/wallet-rpc#get_wallets) | Show all wallets associated with the current fingerprint, including (by default) coin information | +| logIn | [log_in](/wallet-rpc#log_in) | Log into the wallet with the specified key | +| mintNFT | [nft_mint_nft](/nft-rpc/#nft_mint_nft) | Mint an NFT | +| revokeVC | [vc_revoke](/vc-rpc/#vc_revoke) | Revoke an on chain VC provided the correct DID is available | +| sendTransaction | [send_transaction](/wallet-rpc#send_transaction) | Send a transaction | +| setDIDName | [did_set_wallet_name](/did-rpc/#did_set_wallet_name) | Set the name of a DID wallet | +| setNFTDID | [nft_set_nft_did](/nft-rpc/#nft_set_nft_did) | Set the DID for an NFT | +| showNotification | [get_notifications](/wallet-rpc/#get_notifications) | Show notification with offer or general announcement | +| signMessageByAddress | [sign_message_by_address](/wallet-rpc#sign_message_by_address) | Sign a message using an XCH address without incurring an on-chain transaction | +| signMessageById | [sign_message_by_id](/wallet-rpc#sign_message_by_id) | Sign a message using a DID or NFT ID without incurring an on-chain transaction | +| spendCAT | [cat_spend](/wallet-rpc#cat_spend) | Send CAT funds to another wallet | +| spendClawbackCoins | [spend_clawback_coins](/wallet-rpc/#spend_clawback_coins) | Claw back or claim claw back transaction | +| takeOffer | [take_offer](/wallet-rpc#take_offer) | Take an offer | +| transferNFT | [nft_transfer_nft](/nft-rpc#nft_transfer_nft) | Transfer an NFT to a new wallet address | +| spendVC | [vc_spend](/vc-rpc/#vc_spend) | Add Proofs To Verifiable Credential | +| verifySignature | [verify_signature](/wallet-rpc#verify_signature) | Given a public key, message and signature, verify if it is valid | +| waitForConfirmation | | | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md index 3d66259e9f..337df5750f 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md @@ -23,7 +23,7 @@ This guide will show you how to use [WalletConnect](https://walletconnect.com/) ## Install the sample dApp -In order to help you get started with WalletConnect, we have created a sample dApp to run Chia wallet RPCs. In this section, we'll install and run the dApp locally. We'll also obtain a link to connect the dApp to a Chia reference wallet. +In order to help you get started with WalletConnect, we have created a sample dApp to run Chia wallet RPCs. In this section, we'll install and run the dApp locally. We'll also obtain a link to connect the dApp to a Chia reference wallet. In this section, we'll install and run the dApp locally. We'll also obtain a link to connect the dApp to a Chia reference wallet. If you would like to connect your Chia reference wallet to a different dApp, then feel free to skip ahead to the [next section](#configure-walletconnect). @@ -59,7 +59,7 @@ Example result: ➜ press h to show help ``` -In this example, the dApp was started locally on port 5173. This is the default port; your dApp may need to use a different port if 5173 is already being used for something else. +In this example, the dApp was started locally on port 5173. In this example, the dApp was started locally on port 5173. This is the default port; your dApp may need to use a different port if 5173 is already being used for something else. 5. Access the sample dApp: @@ -71,7 +71,7 @@ If you see an error message such as `An error as occurred`, the most likely caus ::: -6. The `WalletConnect Example` screen should be displayed. Click `Link Wallet`: +6. The `WalletConnect Example` screen should be displayed. Click `Link Wallet`: Click `Link Wallet`:
Click Connect @@ -146,7 +146,7 @@ If you used this guide to set up the sample dApp, this was the link you obtained
-7. By default, the wallet that is currently synced will be selected (in the red circle below). Click the `Select Keys` dropdown if you want to connect other wallets, then click `CONTINUE`: +7. By default, the wallet that is currently synced will be selected (in the red circle below). By default, the wallet that is currently synced will be selected (in the red circle below). Click the `Select Keys` dropdown if you want to connect other wallets, then click `CONTINUE`:
Dropdown menu @@ -242,7 +242,7 @@ Returning to the sample dApp, a new dialog with the response will appear. In thi
-You have now installed, configured, and used the sample dApp. Feel free to test the other functions, as well as create your own! + You have now installed, configured, and used the sample dApp. Feel free to test the other functions, as well as create your own! --- @@ -253,7 +253,7 @@ By default, you can only run dApp methods against the wallet key that is current Click the gear icon in the lower left corner of the reference wallet, then click the `INTEGRATION` tab. Two switches will appear at the top of this panel: - `Enable WalletConnect` -- This setting was activated when you enabled WalletConnect earlier in the guide. -- `Key Switching` -- If you activate this setting, your dApp will be able to switch between multiple wallet keys. The selected wallet will need to sync whenever you switch between keys. +- `Key Switching` -- If you activate this setting, your dApp will be able to switch between multiple wallet keys. The selected wallet will need to sync whenever you switch between keys. The selected wallet will need to sync whenever you switch between keys.
Level | Size
(GiB) | Relative
Size | Reward
Increase | Min Spec
Harvester | -| :---------- | :--------------- | :------------------ | :-------------------- | :------------------------ | -| C0 | 101.4 | 100% | 0% | Pi 4 | -| C1 | 87.5 | 86.3% | 15.9% | Pi 4 | -| C2 | 86.0 | 84.8% | 17.9% | Pi 4 | -| C3 | 84.5 | 83.3% | 20.0% | Pi 4 | -| C4 | 82.9 | 81.8% | 22.3% | Desktop CPU | -| C5 | 81.3 | 80.2% | 24.7% | Fast CPU | -| C6 | 79.6 | 78.5% | 27.4% | Fast CPU | -| C7 | 78.0 | 76.9% | 29.8% | GPU | -| C9 | 75.2 | 74.2% | 34.8% | GPU | +|:----------------- |:---------------------- |:------------------------- |:--------------------------- |:------------------------------- | +| C0 | 101.4 | 100% | 0% | Pi 4 | +| C1 | 87.5 | 86.3% | 15.9% | Pi 4 | +| C2 | 86.0 | 84.8% | 17.9% | Pi 4 | +| C3 | 84.5 | 83.3% | 20.0% | Pi 4 | +| C4 | 82.9 | 81.8% | 22.3% | Desktop CPU | +| C5 | 81.3 | 80.2% | 24.7% | Fast CPU | +| C6 | 79.6 | 78.5% | 27.4% | Fast CPU | +| C7 | 78.0 | 76.9% | 29.8% | GPU | +| C9 | 75.2 | 74.2% | 34.8% | GPU | The right column (Min Spec Harvester) shows the minimum type of computer required for harvesting at each compression level, where: - `Pi 4` refers to Chia's minimum spec hardware, the [Raspberry Pi 4](https://www.raspberrypi.com/products/raspberry-pi-4-model-b/) with 4 GB of RAM for CLI farming, or 8 GB for GUI farming. - `Desktop CPU` refers to a power-sipping computer such as the [ASUS Chromebox](https://www.androidcentral.com/best-chromebox). - `Fast CPU` refers to a computer with a higher-end CPU such as an Intel Xeon. -- `GPU` refers to a computer with an Nvidia CUDA-class GPU. The minimum amount of DRAM required is around 600-700 MB for C7 harvesting. For example, a GTX 1060 will work. +- `GPU` refers to a computer with an Nvidia CUDA-class GPU. The minimum amount of DRAM required is around 600-700 MB for C7 harvesting. For example, a GTX 1060 will work. The minimum amount of DRAM required is around 600-700 MB for C7 harvesting. For example, a GTX 1060 will work. :::info @@ -53,15 +53,15 @@ A few things to keep in mind regarding these recommendations: ### TCO spreadsheet -In order to calculate your potential profits from farming at various compression levels, you can use [this spreadsheet](https://docs.google.com/spreadsheets/d/1k6c-OBDtggXqnEfOPdMmq3646puzvOD7dWojwCH2v3c). Simply make a copy of it, then fill in the constants according to your farm. As you will see from the spreadsheet, the compression level you will ultimately choose will depend on a number of factors, such as electricity cost and the size of your farm. +In order to calculate your potential profits from farming at various compression levels, you can use [this spreadsheet](https://docs.google.com/spreadsheets/d/1k6c-OBDtggXqnEfOPdMmq3646puzvOD7dWojwCH2v3c). Simply make a copy of it, then fill in the constants according to your farm. As you will see from the spreadsheet, the compression level you will ultimately choose will depend on a number of factors, such as electricity cost and the size of your farm. Simply make a copy of it, then fill in the constants according to your farm. As you will see from the spreadsheet, the compression level you will ultimately choose will depend on a number of factors, such as electricity cost and the size of your farm. ### Max farm size estimator -The third-party website [xch.farm](https://xch.farm/max-farm-size) has tables for estimating your farm's maximum capacity depending on your CPU/GPU setup. Be sure to pay attention to the `June 2024` column when planning your farm. If your harvester is capable of handling your desired number of plots listed in this column, you should be good to go until 2027 or later. +The third-party website [xch.farm](https://xch.farm/max-farm-size) has tables for estimating your farm's maximum capacity depending on your CPU/GPU setup. Be sure to pay attention to the `June 2024` column when planning your farm. If your harvester is capable of handling your desired number of plots listed in this column, you should be good to go until 2027 or later. Be sure to pay attention to the `June 2024` column when planning your farm. If your harvester is capable of handling your desired number of plots listed in this column, you should be good to go until 2027 or later. ### BladeBit Simulate -The [standalone version of BladeBit](/plotting-software#bladebit-standalone) comes with a simulator that will determine the maximum size of your farm. The basic idea is that you pass in a compressed plot (C1-C9) and it will calculate the maximum number of plots/space your current harvester can handle. +The [standalone version of BladeBit](/plotting-software#bladebit-standalone) comes with a simulator that will determine the maximum size of your farm. The basic idea is that you pass in a compressed plot (C1-C9) and it will calculate the maximum number of plots/space your current harvester can handle. The basic idea is that you pass in a compressed plot (C1-C9) and it will calculate the maximum number of plots/space your current harvester can handle. See the [CLI reference](/plotters-cli#simulate) for a list of options using the simulator. @@ -73,7 +73,7 @@ The simulator's default values are typically fine, other than the filter size. F :::note -It is a good idea to create plots of various sizes (for example, one C3, one C7, and one C9) and then run the simulator against each of them. This will help you to plan for how many harvesters to use, the type of hardware to acquire, etc. +It is a good idea to create plots of various sizes (for example, one C3, one C7, and one C9) and then run the simulator against each of them. This will help you to plan for how many harvesters to use, the type of hardware to acquire, etc. This will help you to plan for how many harvesters to use, the type of hardware to acquire, etc. ::: @@ -91,17 +91,17 @@ The simulator will only work with compressed plots. ::: -The simulator can also be configured to run a real-time simulation against a farm of any given size. This will give you a much better idea of how your system will perform on mainnet. To activate this mode, use the following flags: +The simulator can also be configured to run a real-time simulation against a farm of any given size. This will give you a much better idea of how your system will perform on mainnet. To activate this mode, use the following flags: This will give you a much better idea of how your system will perform on mainnet. To activate this mode, use the following flags: - `--power
@@ -385,7 +388,7 @@ Usage: chia rpc daemon [OPTIONS] is_keyring_locked [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -420,14 +423,14 @@ Usage: chia rpc daemon [OPTIONS] is_running [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------ | :----- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +|:------- |:------ |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | service | STRING | TRUE | The service to query; valid examples include, but are not limited to, "chia_data_layer", "chia_data_layer_http", "chia_wallet", "chia_full_node", "chia_harvester", "chia_farmer", "chia_introducer", "chia_timelord", "chia_timelord_launcher", "chia_full_node_simulator", "chia_seeder", "chia_crawler", "wallet_ui" |
@@ -462,7 +465,7 @@ Usage: chia rpc daemon [OPTIONS] keyring_status [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -505,14 +508,14 @@ Usage: chia rpc daemon [OPTIONS] register_service [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :----- | :------- | :---------------------------------- | +|:------- |:------ |:-------- |:----------------------------------- | | service | STRING | TRUE | The name of the service to register |
@@ -543,14 +546,14 @@ Usage: chia rpc daemon [OPTIONS] remove_keyring_passphrase [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----------------- | :----- | :------- | :-------------------------------------------------------------------------------- | +|:------------------ |:------ |:-------- |:--------------------------------------------------------------------------------- | | current_passphrase | STRING | True | The current passphrase; if entered correctly, it will be removed from the keyring |
@@ -604,7 +607,7 @@ Usage: chia rpc daemon [OPTIONS] running_services [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -645,18 +648,18 @@ Usage: chia rpc daemon [OPTIONS] set_keyring_passphrase [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :----------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| current_passphrase | STRING | True | The current passphrase (if none, use an empty string) | -| new_passphrase | STRING | True | The new passphrase, by default must be at least 8 characters long | -| passphrase_hint | STRING | False | The new passphrase hint, if one is desired | -| save_passphrase | BOOLEAN | False | Whether to save the new passphrase to your system's secure credential store, thus allowing Chia to access your keys without prompting for your passphrase. [Default: False] | +| Flag | Type | Required | Description | +|:------------------ |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| current_passphrase | STRING | True | The current passphrase (if none, use an empty string) | +| new_passphrase | STRING | True | The new passphrase, by default must be at least 8 characters long | +| passphrase_hint | STRING | False | The new passphrase hint, if one is desired | +| save_passphrase | BOOLEAN | False | Whether to save the new passphrase to your system's secure credential store, thus allowing Chia to access your keys without prompting for your passphrase. \[Default: False\] \[Default: False\] |
Example @@ -687,14 +690,14 @@ Usage: chia rpc daemon [OPTIONS] start_service [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :------ | :------- | :------------------------------------------------------------ | +|:------- |:------- |:-------- |:------------------------------------------------------------- | | service | STRING | True | The service to start | | testing | Boolean | False | If `true`, then test the start_service RPC [Default: `false`] | @@ -730,14 +733,14 @@ Usage: chia rpc daemon [OPTIONS] stop_service [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :----- | :------- | :------------------ | +|:------- |:------ |:-------- |:------------------- | | service | STRING | True | The service to stop |
@@ -771,14 +774,14 @@ Usage: chia rpc daemon [OPTIONS] unlock_keyring [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :----- | :------- | :-------------------------------- | +|:---- |:------ |:-------- |:--------------------------------- | | key | STRING | False | The key to unlock [Default: None] |
@@ -810,14 +813,14 @@ Usage: chia rpc daemon [OPTIONS] validate_keyring_passphrase [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :----- | :------- | :--------------- | +|:---- |:------ |:-------- |:---------------- | | key | STRING | True | The key to check |
@@ -851,14 +854,14 @@ Usage: chia rpc daemon [OPTIONS] get_keys_for_plotting [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----------- | :----- | :------- | :------------------------------------------------------------------------------------------ | +|:------------ |:------ |:-------- |:------------------------------------------------------------------------------------------- | | fingerprints | NUMBER | False | List the keys for the specified fingerprints only [Default: list keys for all fingerprints] |
@@ -897,7 +900,7 @@ Usage: chia rpc daemon [OPTIONS] get_plotters [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -950,14 +953,14 @@ Usage: chia rpc daemon [OPTIONS] start_plotting [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :------ | :------- | :--------------------------------------------------------------------- | +|:--------- |:------- |:-------- |:---------------------------------------------------------------------- | | service | STRING | True | The plotting service to use | | plotter | STRING | False | The plotter to use [Default: "chiapos"] | | delay | INTEGER | False | The number of seconds to delay before starting to plot [Default: 0] | @@ -985,14 +988,14 @@ Usage: chia rpc daemon [OPTIONS] stop_plotting [REQUEST] Options: Stop creating a plot | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :----- | :------- | :---------------------------------- | +|:---- |:------ |:-------- |:----------------------------------- | | id | STRING | True | The ID of the plot to stop creating |
@@ -1025,14 +1028,14 @@ Usage: chia rpc daemon [OPTIONS] add_private_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :----- | :------- | :----------------------------------------------- | +|:-------- |:------ |:-------- |:------------------------------------------------ | | mnemonic | STRING | True | The mnemonic word list (see below for details) | | label | STRING | False | The label to assign for this key [Default: None] | @@ -1068,7 +1071,7 @@ Response:
Example 2: invalid length -The mnemonic must be either 12 or 24 words. Else, an error will be returned. For example: +The mnemonic must be either 12 or 24 words. Else, an error will be returned. For example: Else, an error will be returned. For example: ```json chia rpc daemon add_private_key '{"mnemonic": "1 2 3 4 5 6 7 8 9 10 11 12 13", "label": "Example Key"}' @@ -1088,7 +1091,7 @@ Response:
Example 3: invalid word -Each word must be in the BIP-39 word list. Else, an error will be returned. For example: +Each word must be in the BIP-39 word list. Else, an error will be returned. For example: Else, an error will be returned. For example: ```json chia rpc daemon add_private_key '{"mnemonic": "1 2 3 4 5 6 7 8 9 10 11 12", "label": "Example Key"}' @@ -1108,7 +1111,7 @@ Response:
Example 4: Invalid word order -If the mnemonic is 12 or 24 words, and each word is in the BIP-39 word list, the final check is that the words form a valid mnemonic phrase. For example: +If the mnemonic is 12 or 24 words, and each word is in the BIP-39 word list, the final check is that the words form a valid mnemonic phrase. For example: For example: ```json chia rpc daemon add_private_key '{"mnemonic": "you can test this example word list because they tell you stuff", "label": "Example Key"}' @@ -1136,14 +1139,14 @@ Usage: chia rpc daemon [OPTIONS] check_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | -| :-------- | :----- | :------- | +|:--------- |:------ |:-------- | | root_path | STRING | True | --- @@ -1157,7 +1160,7 @@ Usage: chia rpc daemon [OPTIONS] delete_all_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1167,7 +1170,7 @@ Note that this command will fail if the OS key ring is locked. :::warning -This command will delete all of your local Chia keys. Use with caution. +This command will delete all of your local Chia keys. Use with caution. Use with caution. ::: @@ -1182,14 +1185,14 @@ Usage: chia rpc daemon [OPTIONS] delete_key_by_fingerprint [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :------ | :------- | :------------------------------------------- | +|:----------- |:------- |:-------- |:-------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose key you want to delete | Note that this command will fail if the OS key ring is locked. @@ -1209,7 +1212,7 @@ Response: } ``` -To verify that the key was deleted, you can call `get_public_key`. For example: +To verify that the key was deleted, you can call `get_public_key`. For example: For example: ```json chia rpc daemon get_public_key '{"fingerprint": 1542304282}' @@ -1240,7 +1243,7 @@ Usage: chia rpc daemon [OPTIONS] get_all_private_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1286,7 +1289,7 @@ Usage: chia rpc daemon [OPTIONS] get_first_private_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1324,14 +1327,14 @@ Usage: chia rpc daemon [OPTIONS] get_key_for_fingerprint [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :------ | :------- | :------------------------------------------------------ | +|:----------- |:------- |:-------- |:------------------------------------------------------- | | fingerprint | INTEGER | False | The fingerprint to look up [Default: get the first key] |
@@ -1364,14 +1367,14 @@ Usage: chia rpc daemon [OPTIONS] get_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------------- | :------ | :------- | :------------------------------------------------------------------ | +|:--------------- |:------- |:-------- |:------------------------------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose key you want to look up | | include_secrets | BOOLEAN | False | Set to `true` to include secrets in the response [Default: `false`] | @@ -1409,14 +1412,14 @@ Usage: chia rpc daemon [OPTIONS] get_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------------- | :------ | :------- | :------------------------------------------------------------------ | +|:--------------- |:------- |:-------- |:------------------------------------------------------------------- | | include_secrets | BOOLEAN | False | Set to `true` to include secrets in the response [Default: `false`] |
@@ -1455,14 +1458,14 @@ Usage: chia rpc daemon [OPTIONS] get_public_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :------ | :------- | :-------------------------------------------- | +|:----------- |:------- |:-------- |:--------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose key you want to look up |
@@ -1498,7 +1501,7 @@ Usage: chia rpc daemon [OPTIONS] get_public_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1539,14 +1542,14 @@ Usage: chia rpc daemon [OPTIONS] set_label [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :------ | :------- | :------------------------------------------ | +|:----------- |:------- |:-------- |:------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose label you want to set | | label | STRING | True | The new label | @@ -1565,7 +1568,7 @@ Response: } ``` -To verify that the label was set, you can call `get_public_key`. For example: +To verify that the label was set, you can call `get_public_key`. For example: For example: ```json chia rpc daemon get_public_key '{"fingerprint": 1542304282}' @@ -1597,14 +1600,14 @@ Usage: chia rpc daemon [OPTIONS] delete_label [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :------ | :------- | :--------------------------------------------- | +|:----------- |:------- |:-------- |:---------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose label you want to delete |
@@ -1622,7 +1625,7 @@ Response: } ``` -To verify that the label was set, you can call `get_public_key`. For example: +To verify that the label was set, you can call `get_public_key`. For example: For example: ```json chia rpc daemon get_public_key '{"fingerprint": 1542304282}' diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md index 720cb5a72e..ea30112c80 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md @@ -15,6 +15,12 @@ Prior to using the DAO alpha primitive, be sure to read the [list of known issue ::: +:::note + +The RPC to create a new DAO is a **wallet RPC** called [create_new_wallet](/wallet-rpc/#create_new_wallet), therefore it is not documented here. See Example 7 for details of how this command's options can be used. + +::: +
Note about Windows command escaping @@ -51,12 +57,12 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------------- | ------ | :------- | :------------------------------------------------------------------------------------ | -| wallet_id | NUMBER | True | The DAO wallet to which to add funds. Must be of type `DAOWallet` | -| funding_wallet_id | NUMBER | True | The wallet from which the funds will come. Must be of type `STANDARD_WALLET` or `CAT` | -| amount | NUMBER | True | The amount of funds to add, in mojos | -| fee | NUMBER | False | An optional blockchain fee, in mojos \[Default: 0] | +| Flag | Type | Required | Description | +| :---------------------------------------------------------- | ------ | :------- | :---------------------------------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The DAO wallet to which to add funds. Must be of type `DAOWallet` | +| funding_wallet_id | NUMBER | True | The wallet from which the funds will come. Must be of type `STANDARD_WALLET` or `CAT` | +| amount | NUMBER | True | The amount of funds to add, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos \[Default: 0] |
Example @@ -194,10 +200,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------- | ------ | :------- | :-------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------------------------------- | ------ | :------- | :------------------------------------------------------------------------------------------------------------ | | wallet_id | NUMBER | True | The ID of the wallet whose filter level you would like to adjust. Must be of type `DAOWallet` | -| filter_level | NUMBER | True | The new filter level. Propos with fewer votes than this will not be shown. | +| filter_level | NUMBER | True | The new filter level. Propos with fewer votes than this will not be shown. | --- @@ -216,11 +222,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------- | ------ | :------- | :------------------------------------------------------------------------------------ | +| Flag | Type | Required | Description | +| :------------------------------- | ------ | :------- | :---------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet that contains the proposal to close. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal to close | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| proposal_id | STRING | True | The ID of the proposal to close | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -239,12 +245,12 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------ | ------ | :------- | :--------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :--------------------------------- | ------ | :------- | :------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO wallet to use for creating the proposal. Must be of type `DAOWallet` | -| proposal_type | STRING | True | Must be either `spend`, `update`, or `mint` | -| vote_amount | NUMBER | False | The number of votes to add | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| proposal_type | STRING | True | Must be either `spend`, `update`, or `mint` | +| vote_amount | NUMBER | False | The number of votes to add | +| fee | NUMBER | False | An optional blockchain fee, in mojos | Proposal Types: @@ -258,38 +264,38 @@ If the proposal is of type `spend`, then `additions` may optionally be included `additions` is a list with the following elements: -| Element | Required | Description | -| :---------- | :------- | :-------------------------------------------------- | +| Element | Required | Description | +| :------------------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | | asset_id | False | The asset_id of the funds to spend \[Default: None] | -| puzzle_hash | True | The puzzle_hash of the funds to spend | -| amount | True | The amount, in mojos, to spend | +| puzzle_hash | True | The puzzle_hash of the funds to spend | +| amount | True | The amount, in mojos, to spend | If the proposal is of type `spend`, and `additions` is not included, then the following **request parameters** will be used instead: -| Parameter | Required | Description | -| :------------ | :------- | :-------------------------------------------------- | +| Parameter | Required | Description | +| :--------------------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | | asset_id | False | The asset_id of the funds to spend \[Default: None] | -| inner_address | True | The inner address of the funds to spend | -| amount | True | The amount, in mojos, to spend | +| inner_address | True | The inner address of the funds to spend | +| amount | True | The amount, in mojos, to spend | If the proposal is of type `update`, then the **request parameter** `new_dao_rules` is required. `new_dao_rules` is a list of optional rules to update. If a rule is missing from this list, it will not be updated: -| Rule | Required | Description | -| :------------------- | :------- | :------------------------------------------------------------------------------------------------- | -| proposal_timelock | False | The new minimum number of blocks before a proposal can close | -| soft_close_length | False | The number of blocks a proposal must remain unspent before closing | -| attendance_required | False | The minimum number of votes a proposal must receive to be accepted | -| pass_percentage | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | -| self_destruct_length | False | The number of blocks required before a proposal can be automatically removed | -| oracle_spend_delay | False | The number of blocks required between oracle spends of the treasury | +| Rule | Required | Description | +| :------------------------------------------------------------- | :------- | :----------------------------------------------------------------------------------------------------------------- | +| proposal_timelock | False | The new minimum number of blocks before a proposal can close | +| soft_close_length | False | The number of blocks a proposal must remain unspent before closing | +| attendance_required | False | The minimum number of votes a proposal must receive to be accepted | +| pass_percentage | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | +| self_destruct_length | False | The number of blocks required before a proposal can be automatically removed | +| oracle_spend_delay | False | The number of blocks required between oracle spends of the treasury | If the proposal is of type `mint`, then the following **request parameters** are required: -| Parameter | Required | Description | -| :----------------- | :------- | :------------------------------------------- | -| amount | True | The number of DAO CATs to mint | +| Parameter | Required | Description | +| :----------------------------------------------------------- | :------- | :------------------------------------------- | +| amount | True | The number of DAO CATs to mint | | cat_target_address | True | The xch address that will receive the tokens | --- @@ -309,11 +315,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------- | ------ | :------- | :----------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----------------------------- | ------ | :------- | :--------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet from which to release the DAO CATs. Must be of type `DAOWallet` | -| coins | STRING | False | A list of coin IDs to release | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| coins | STRING | False | A list of coin IDs to release | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -332,10 +338,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------- | ------ | :------- | :----------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----------------------------- | ------ | :------- | :--------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet from which to release the DAO CATs. Must be of type `DAOWallet` | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -354,8 +360,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------- | ------ | :------- | :------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----------------------------- | ------ | :------- | :------------------------------------------------------------------- | | wallet_id | NUMBER | True | The wallet from which to list proposals; must be of type `DAOWallet` |
@@ -418,10 +424,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------- | ------ | :------- | :---------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :------------------------------- | ------ | :------- | :-------------------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the DAO wallet from which to look up a proposal's status. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal whose status you would like to show | +| proposal_id | STRING | True | The ID of the proposal whose status you would like to show |
Example @@ -493,8 +499,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------- | ------ | :------- | :----------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----------------------------- | ------ | :------- | :--------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO wallet from which to show the rules. Must be of type `DAOWallet` |
@@ -542,8 +548,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------- | ------ | :------- | :--------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----------------------------- | ------ | :------- | :------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO whose treasury balance you would like to show. Must be of type `DAOWallet` |
@@ -585,8 +591,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------- | ------ | :------- | :------------------------------------------------------------------------------ | +| Flag | Type | Required | Description | +| :----------------------------- | ------ | :------- | :---------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO wallet whose ID you would like to retrieve. Must be of type `DAOWallet` |
@@ -621,10 +627,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------- | ------ | :------- | :------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :------------------------------- | ------ | :------- | :----------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO wallet where the proposal lives. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal whose details you would like to show | +| proposal_id | STRING | True | The ID of the proposal whose details you would like to show |
Example @@ -679,10 +685,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------- | ------ | :------- | :---------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----------------------------- | ------ | :------- | :-------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet from which to lock DAO CATs. Must be of type `DAOWallet` | -| amount | NUMBEr | True | The amount of CATs to lock for voting | +| amount | NUMBEr | True | The amount of CATs to lock for voting | --- @@ -701,12 +707,12 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------- | ------- | :------- | :------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the wallet where the proposal lives. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal on which you would like to vote | -| vote_amount | NUMBER | False | The number of DAO CATs to use for this vote \[Default: None] | -| is_yes_vote | BOOLEAN | True | A boolean indicating whether this vote is "yes" (`true`) or "no" (`false`) | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| Flag | Type | Required | Description | +| :---------------------------------------------------- | ------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the wallet where the proposal lives. Must be of type `DAOWallet` | +| proposal_id | STRING | True | The ID of the proposal on which you would like to vote | +| vote_amount | NUMBER | False | The number of DAO CATs to use for this vote \[Default: None] | +| is_yes_vote | BOOLEAN | True | A boolean indicating whether this vote is "yes" (`true`) or "no" (`false`) | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md index 959fbefbad..717f67a364 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md @@ -55,14 +55,14 @@ Usage: chia rpc data_layer [OPTIONS] add_mirror [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------- | +|:------ |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | | id | TEXT | True | The hexadecimal ID of the store to mirror | | urls | TEXT | True | A list of URLs where the mirror will reside | | amount | INTEGER | True | The number of mojos to spend to create the mirror. In theory, mirrors with a higher `amount` will be prioritized | @@ -100,16 +100,16 @@ Usage: chia rpc data_layer [OPTIONS] add_missing_files [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :--------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------- | -| ids | TEXT | False | A list of hexadecimal store IDs to restore (default: all subscribed stores) | -| override | BOOLEAN | False | If `True`, will overwrite files that already exist (default: `False`) | +| Flag | Type | Required | Description | +|:---------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------- | +| ids | TEXT | False | A list of hexadecimal store IDs to restore (default: all subscribed stores) | +| override | BOOLEAN | False | If `True`, will overwrite files that already exist (default: `False`) | | foldername | TEXT | False | The name of the folder where the files to be restored are located (default: `~/.chia/mainnet/data_layer/db/server_files_location_`) |
@@ -175,17 +175,24 @@ Usage: chia rpc data_layer [OPTIONS] batch_update [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :--------- | :--- | :------- | :---------------------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| changelist | TEXT | True | A string representing the changelist | -| fee | TEXT | False | Set the fee for the transaction, in mojos | +| Flag | Type | Required | Description | +|:----------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------- | +| id | TEXT | True | The hexadecimal store ID | +| changelist | TEXT | True | A string representing the changelist | +| submit_on_chain | BOOLEAN | False | Specify whether to submit the update to the blockchain (`True`), or to store it locally (`False`). Default: `True` (See info box for details) | +| fee | TEXT | False | Set the fee for the transaction, in mojos | + +:::info + +The `submit_on_chain` flag was added in Chia version 2.3.0. In order to support the new functionality (submit an update off-chain), the schema for your `root` table will be upgraded automatically upon starting the DataLayer service. This upgrade takes about three minutes to complete. + +::: A few notes on the `changelist` option: @@ -386,14 +393,14 @@ Usage: chia rpc data_layer [OPTIONS] cancel_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:-------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | trade_id | TEXT | True | The `trade_id` of the offer. This is displayed with the response of the [make_offer](#make_offer) RPC | | secure | BOOLEAN | True | If `true`, the offer will be canceled on the blockchain, making it impossible to be accepted later. If `false`, the offer will only be canceled locally. We recommend that you set this to `true` unless you are certain that the offer file has not left your computer | | fee | TEXT | False | If `secure` is `true`, this will set the fee for the transaction, in mojos. If `secure` is `false`, the fee will be ignored | @@ -428,7 +435,7 @@ Usage: chia rpc data_layer [OPTIONS] check_plugins [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -466,14 +473,14 @@ Usage: chia rpc data_layer [OPTIONS] clear_pending_roots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :--- | :------- | :----------------------- | +|:-------- |:---- |:-------- |:------------------------ | | store_id | TEXT | True | The hexadecimal store ID |
@@ -510,14 +517,14 @@ Usage: chia rpc data_layer [OPTIONS] create_data_store [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :---------------------------------------- | +|:---- |:---- |:-------- |:----------------------------------------- | | fee | TEXT | False | Set the fee for the transaction, in mojos |
@@ -681,14 +688,14 @@ Usage: chia rpc data_layer [OPTIONS] delete_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :---------------------------------------- | +|:---- |:---- |:-------- |:----------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | key | TEXT | True | The hexadecimal key | | fee | TEXT | False | Set the fee for the transaction, in mojos | @@ -724,14 +731,14 @@ Usage: chia rpc data_layer [OPTIONS] delete_mirror [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :--------------------------------------------------------------------------------------- | +|:---- |:---- |:-------- |:---------------------------------------------------------------------------------------- | | id | TEXT | True | The `coin_id` of the mirror to delete, obtainable by running [get_mirrors](#get_mirrors) | | fee | TEXT | False | Set the fee for the transaction, in mojos | @@ -780,14 +787,14 @@ Usage: chia rpc data_layer [OPTIONS] get_ancestors [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :--------------------------------------- | +|:---- |:---- |:-------- |:---------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | hash | TEXT | True | The hash from which to display ancestors | @@ -839,16 +846,18 @@ Usage: chia rpc data_layer [OPTIONS] get_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :-------- | :--- | :------- | :-------------------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| root_hash | TEXT | False | The root hash from which to obtain data | +| Flag | Type | Required | Description | +|:--------------- |:------ |:-------- |:------------------------------------------------------------------------------------------------- | +| id | TEXT | True | The hexadecimal store ID | +| root_hash | TEXT | False | The root hash from which to obtain data | +| page | NUMBER | False | Enables pagination of the output and requests a specific page | +| max_page_size | NUMBER | False | Set how many bytes to be included in a page. Only used if pagination is enabled. Default is 40 MB | :::info @@ -856,6 +865,14 @@ The `root_hash` parameter is recommended to be used each time you call this RPC. ::: +:::info + +Pagination is disabled by default. If it is enabled (by using the `page` flag), then the JSON response will include `total_pages` and `total_bytes`, in addition to the data. + +If an item is larger than `max_page_size`, an error will be thrown. + +::: +
Example @@ -885,16 +902,18 @@ Usage: chia rpc data_layer [OPTIONS] get_keys_values [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :-------: | :--: | :------: | :-------------------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| root_hash | TEXT | False | The root hash from which to obtain data | +| Flag | Type | Required | Description | +|:---------------:|:------:|:--------:|:------------------------------------------------------------------------------------------------- | +| id | TEXT | True | The hexadecimal store ID | +| root_hash | TEXT | False | The root hash from which to obtain data | +| page | NUMBER | False | Enables pagination of the output and requests a specific page | +| max_page_size | NUMBER | False | Set how many bytes to be included in a page. Only used if pagination is enabled. Default is 40 MB | :::info @@ -902,6 +921,14 @@ The `root_hash` parameter is recommended to be used each time you call this RPC. ::: +:::info + +Pagination is disabled by default. If it is enabled (by using the `page` flag), then the JSON response will include `total_pages` and `total_bytes`, in addition to the data. + +If an item is larger than `max_page_size`, an error will be thrown. + +::: +
Example @@ -999,17 +1026,27 @@ Usage: chia rpc data_layer [OPTIONS] get_kv_diff [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :----- | :--- | :------- | :------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| hash_1 | TEXT | True | The first hash to compare | -| hash_2 | TEXT | True | The second hash to compare | +| Flag | Type | Required | Description | +|:--------------- |:------ |:-------- |:------------------------------------------------------------------------------------------------- | +| id | TEXT | True | The hexadecimal store ID | +| hash_1 | TEXT | True | The first hash to compare | +| hash_2 | TEXT | True | The second hash to compare | +| page | NUMBER | False | Enables pagination of the output and requests a specific page | +| max_page_size | NUMBER | False | Set how many bytes to be included in a page. Only used if pagination is enabled. Default is 40 MB | + +:::info + +Pagination is disabled by default. If it is enabled (by using the `page` flag), then the JSON response will include `total_pages` and `total_bytes`, in addition to the data. + +If an item is larger than `max_page_size`, an error will be thrown. + +:::
Example @@ -1051,14 +1088,14 @@ Usage: chia rpc data_layer [OPTIONS] get_local_root [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters:s | Flag | Type | Required | Description | -| :--- | :--- | :------- | :----------------------- | +|:---- |:---- |:-------- |:------------------------ | | id | TEXT | True | The hexadecimal store ID |
@@ -1090,14 +1127,14 @@ Usage: chia rpc data_layer [OPTIONS] get_mirrors [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :-------------------------------------------------------- | +|:---- |:---- |:-------- |:--------------------------------------------------------- | | id | TEXT | True | The hexadecimal ID of the store for which to list mirrors |
@@ -1137,7 +1174,7 @@ Usage: chia rpc data_layer [OPTIONS] get_owned_stores [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1165,6 +1202,64 @@ Response: --- +### `get_proof` + +Functionality: Obtains a merkle proof of inclusion for a given key + +Usage: chia rpc data_layer [OPTIONS] get_proof [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +|:-------- |:----------- |:-------- |:------------------------------------------- | +| store_id | TEXT | True | The hexadecimal store ID | +| keys | STRING LIST | True | A list of keys for which to retrieve proofs | + +The proof is a proof of inclusion that a given key, value pair is in the specified datalayer store by chaining the Merkle hashes up to the published on-chain root hash. + +A user can generate a proof for multiple k,v pairs in the same datastore. + +
+Example + +```json +chia rpc data_layer get_proof '{"store_id": "7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e", "keys": ["0x0003"]}' +``` + +Response: + +```json +{ + "proof": { + "coin_id": "0x774e5f9ba7a8afbfa7fd2050347b4a2d400d3cd530637a18b61b094bb5a0f756", + "inner_puzzle_hash": "0x875cc80014bc72f2028c27500d5b44bf6906cd13ad16d7b5f4a5da77a06c8c2f", + "store_proofs": { + "proofs": [ + { + "key_clvm_hash": "0xa143e7ffd81147f136f921fef88760c46c7a05f15b81995f9c5cfed2a737a3f1", + "layers": [], + "node_hash": "0xe488fa1bf0f712b224df0daf312b3d479f80e3a330d4bebd8f26a0d52dc0ebbb", + "value_clvm_hash": "0xed052604ee4ff3996c15ef9b2cb0925233a2e78b6168bb6e67d133e074109b42" + } + ], + "store_id": "0x7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e" + } + }, + "success": true +} +``` + +
+ +--- + ### `get_root` Functionality: Get the root hash and timestamp of a given store ID. If it is a subscribed store, this command will return an invalid hash (see example). In this case, use [get_local_root](#get_local_root) instead @@ -1174,14 +1269,14 @@ Usage: chia rpc data_layer [OPTIONS] get_root [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :----------------------- | +|:---- |:---- |:-------- |:------------------------ | | id | TEXT | True | The hexadecimal store ID |
@@ -1239,14 +1334,14 @@ Usage: chia rpc data_layer [OPTIONS] get_roots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :------------------------------ | +|:---- |:---- |:-------- |:------------------------------- | | ids | TEXT | True | A list of hexadecimal store IDs |
@@ -1293,14 +1388,14 @@ Usage: chia rpc data_layer [OPTIONS] get_root_history [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :----------------------- | +|:---- |:---- |:-------- |:------------------------ | | id | TEXT | True | The hexadecimal store ID |
@@ -1373,7 +1468,7 @@ Usage: chia rpc data_layer [OPTIONS] get_routes Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1391,9 +1486,11 @@ Response: ```json { "routes": [ + "/wallet_log_in", "/create_data_store", "/get_owned_stores", "/batch_update", + "/submit_pending_root", "/get_value", "/get_keys", "/get_keys_values", @@ -1419,6 +1516,9 @@ Response: "/cancel_offer", "/get_sync_status", "/check_plugins", + "/clear_pending_roots", + "/get_proof", + "/verify_proof", "/get_connections", "/open_connection", "/close_connection", @@ -1443,14 +1543,14 @@ Usage: chia rpc data_layer [OPTIONS] get_sync_status [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :----------------------- | +|:---- |:---- |:-------- |:------------------------ | | id | TEXT | True | The hexadecimal store ID |
@@ -1487,14 +1587,14 @@ Usage: chia rpc data_layer [OPTIONS] get_value [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :--- | :------- | :-------------------------------------- | +|:--------- |:---- |:-------- |:--------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | key | TEXT | True | The hexadecimal key | | root_hash | TEXT | False | The root hash from which to obtain data | @@ -1536,14 +1636,14 @@ Usage: chia rpc data_layer [OPTIONS] insert [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :--- | :------- | :---------------------------------------- | +|:----- |:---- |:-------- |:----------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | key | TEXT | True | The hexadecimal key | | value | TEXT | True | The hexadecimal value | @@ -1600,14 +1700,14 @@ Usage: chia rpc data_layer [OPTIONS] make_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :--- | :------- | :-------------------------------------------------------- | +|:----- |:---- |:-------- |:--------------------------------------------------------- | | maker | TEXT | True | The hexadecimal ID of the store for which to list mirrors | | fee | TEXT | False | Set the fee for the offer, in mojos | @@ -1808,14 +1908,14 @@ Usage: chia rpc data_layer [OPTIONS] remove_subscriptions [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :--------------------------------------- | +|:---- |:---- |:-------- |:---------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | urls | TEXT | True | A list of URLs from which to unsubscribe | @@ -1838,6 +1938,27 @@ Response: --- +### `submit_pending_root` + +Functionality: Publish the root from all pending batch updates + +Usage: chia rpc data_layer [OPTIONS] submit_pending_root [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +|:---- |:---- |:-------- |:------------------------ | +| id | TEXT | True | The hexadecimal store ID | + +--- + ### `subscribe` Functionality: Subscribe to a store ID @@ -1847,14 +1968,14 @@ Usage: chia rpc data_layer [OPTIONS] subscribe [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :----------------------------------------------------------------------- | +|:---- |:---- |:-------- |:------------------------------------------------------------------------ | | id | TEXT | True | The hexadecimal store ID | | urls | TEXT | True | A list of URLs where the data store resides. This list can be left blank | @@ -1907,7 +2028,7 @@ Usage: chia rpc data_layer [OPTIONS] subscriptions [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1948,14 +2069,14 @@ Usage: chia rpc data_layer [OPTIONS] take_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :--- | :------- | :----------------------------------------------------------------------------------------------------- | +|:----- |:---- |:-------- |:------------------------------------------------------------------------------------------------------ | | offer | TEXT | False | The offer, in JSON format (the output from the `make_offer` RPC). Includes Maker and Taker information | | fee | TEXT | False | Set the fee for the offer, in mojos | @@ -2060,14 +2181,14 @@ Usage: chia rpc data_layer [OPTIONS] unsubscribe [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :--- | :------- | :-------------------------------------------------------- | +|:---- |:---- |:-------- |:--------------------------------------------------------- | | id | TEXT | True | The hexadecimal ID of the store from which to unsubscribe | :::info @@ -2108,14 +2229,14 @@ Usage: chia rpc data_layer [OPTIONS] verify_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :--- | :------- | :----------------------------------------------------------------------------------------------------- | +|:----- |:---- |:-------- |:------------------------------------------------------------------------------------------------------ | | offer | TEXT | False | The offer, in JSON format (the output from the `make_offer` RPC). Includes Maker and Taker information |
@@ -2161,6 +2282,68 @@ Request failed: {'error': 'non-hexadecimal number found in fromhex() arg at posi --- +### `verify_proof` + +Functionality: Verifies a merkle proof of inclusion + +Usage: chia rpc data_layer [OPTIONS] verify_proof [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +|:------------------- |:------ |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| store_proofs | STRING | True | The proof to verify; requires a `proofs` parameter, which must contain the following parameters: `key_clvm_hash`, `value_clvm_hash`, `node_hash`, `layers`. See the example for usage. | +| coin_id | STRING | True | The ID of the coin to retrieve | +| inner_puzzle_hash | STRING | True | The proof's inner puzzle hash | + +Notes about this command: + +- It only needs to perform a single lookup of the on-chain root. +- It doesn't need to have synced any of the data, or be subscribed to the data store. +- To keep the proofs smaller, only the clvm hash of the key and value are included in the proof, and not the actual key or value. (A clvm hash is just a sha256 hash of the data prepended with 0x01.) +- Datalayer uses CLVM hashes for ease of verification in CLVM, although for this specific use case, there is no on-chain validation happening. +- When using this command, pay attention to the `current_root` value in the returned JSON. + - If `current_root` is `True`, this data chains to the current published root, and so if you synced the data, you can be sure it would be there. + - If `current_root` is `False`, the root has moved from the time the proof was generated. You cannot make any assumptions in this case about whether the data is in fact in the datastore or not since the root has changed, therefore the data might have changed. It is up to the caller to determine how to treat this case; one possible action would be to obtain a new proof. + +For more help with constructing the `store_proofs` JSON, see the output from the [get_proof](#get_proof) RPC. For more examples, see chia-blockchain [PR #16845](https://github.com/Chia-Network/chia-blockchain/pull/16845). + +
+Example + +```json +chia rpc data_layer verify_proof '{"coin_id": "0x774e5f9ba7a8afbfa7fd2050347b4a2d400d3cd530637a18b61b094bb5a0f756", "inner_puzzle_hash": "0x875cc80014bc72f2028c27500d5b44bf6906cd13ad16d7b5f4a5da77a06c8c2f", "store_proofs": {"proofs": [{"key_clvm_hash": "0xa143e7ffd81147f136f921fef88760c46c7a05f15b81995f9c5cfed2a737a3f1","layers": [], "node_hash": "0xe488fa1bf0f712b224df0daf312b3d479f80e3a330d4bebd8f26a0d52dc0ebbb", "value_clvm_hash": "0xed052604ee4ff3996c15ef9b2cb0925233a2e78b6168bb6e67d133e074109b42"}], "store_id": "0x7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e"}}' +``` + +Response: + +```json +{ + "current_root": true, + "success": true, + "verified_clvm_hashes": { + "inclusions": [ + { + "key_clvm_hash": "0xa143e7ffd81147f136f921fef88760c46c7a05f15b81995f9c5cfed2a737a3f1", + "value_clvm_hash": "0xed052604ee4ff3996c15ef9b2cb0925233a2e78b6168bb6e67d133e074109b42" + } + ], + "store_id": "0x7de232eecc08dc5e524ad42fad205c9ec7dd3f342677edb7c2e139c51f55d40e" + } +} +``` + +
+ +--- + ### `wallet_log_in` Functionality: Request that the wallet service be logged in to the specified fingerprint @@ -2168,14 +2351,14 @@ Functionality: Request that the wallet service be logged in to the specified fin Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :----- | :------- | :----------------------------------- | +|:----------- |:------ |:-------- |:------------------------------------ | | fingerprint | STRING | True | The fingerprint of the wallet to use |
@@ -2210,14 +2393,14 @@ Usage: chia rpc data_layer [OPTIONS] close_connection [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-----: | :--: | :------: | :------------------------------------------------------------------------------------- | +|:-------:|:----:|:--------:|:-------------------------------------------------------------------------------------- | | node_id | TEXT | True | The hex ID of the node to close, obtainable from [`get_connections`](#get_connections) |
@@ -2265,7 +2448,7 @@ Usage: chia rpc data_layer [OPTIONS] get_connections [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -2315,14 +2498,14 @@ Usage: chia rpc data_layer [OPTIONS] open_connection [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :------ | :------- | :--------------------------------------------------- | +|:---- |:------- |:-------- |:---------------------------------------------------- | | host | TEXT | True | The IP or URL of the node to connect to | | port | INTEGER | True | The port through which to connect to the remote node | @@ -2356,7 +2539,7 @@ Note: Inherited from RPC Server Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md index c9dd3f844d..252d1ef393 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md @@ -39,20 +39,20 @@ Note: This is part of the wallet RPC API. It is included here to document the on Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -| :----------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------- | -| wallet_type | True | This must be set to `did_wallet` in order to create a DID wallet | -| did_type | True | Set this to `new` to create a new DID | -| amount | True | Number of mojos to add to the DID initially. Minimum value is `1` | -| backup_dids | True | A list of DIDs to be used for recovery. Must match actual DIDs | +| Parameter | Required | Description | +|:---------------------------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------- | +| wallet_type | True | This must be set to `did_wallet` in order to create a DID wallet | +| did_type | True | Set this to `new` to create a new DID | +| amount | True | Number of mojos to add to the DID initially. Minimum value is `1` | +| backup_dids | True | A list of DIDs to be used for recovery. Must match actual DIDs | | num_of_backup_ids_needed | True | The number of backup DIDs required for recovery. Minimum value is `1`, maximum value is the number of DIDs in `backup_dids` | -| fee | False | An optional blockchain fee, in mojos | +| fee | False | An optional blockchain fee, in mojos |
Example @@ -114,14 +114,14 @@ Usage: chia rpc wallet [OPTIONS] did_create_attest [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :------------------------------------------- | +|:--------- |:-------- |:-------------------------------------------- | | wallet_id | True | The Wallet ID for which to create the attest | | coin_name | True | The coin to use for the attest | | pubkey | True | The public key to use for the attest | @@ -224,14 +224,14 @@ Usage: chia rpc wallet [OPTIONS] did_create_backup_file [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :----------------------------------------------------------------- | +|:--------- |:-------- |:------------------------------------------------------------------ | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the coin info |
@@ -265,18 +265,18 @@ Usage: chia rpc wallet [OPTIONS] did_find_lost_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Type | Required | Description | -| :----------------- | :----- | :------- | :---------------------------------------------------------------------------------------------------------------------------------- | -| coin_id | STRING | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | +| Parameter | Type | Required | Description | +|:-------------------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | +| coin_id | STRING | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | | recovery_list_hash | STRING | False | Override the recovery list hash of the DID. Only set this if your last DID spend updated the recovery list | -| num_verification | NUMBER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | -| metadata | STRING | False | The new whole metadata in json format | +| num_verification | NUMBER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | +| metadata | STRING | False | The new whole metadata in json format |
Example 1 @@ -326,14 +326,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_current_coin_info [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :----------------------------------------------------------------- | +|:--------- |:-------- |:------------------------------------------------------------------ | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the coin info |
@@ -369,14 +369,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :------------------------------------------------------------ | +|:--------- |:-------- |:------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet for which to get the DID info |
@@ -410,14 +410,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_info [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :----- | :------- | :-------------------------------------------------------------------------------- | +|:------- |:------ |:-------- |:--------------------------------------------------------------------------------- | | coin_id | NUMBER | True | The coin ID of the DID get info (can be in the `0x618...` or `did:chia:16` format |
@@ -457,14 +457,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_information_needed_for_recovery [REQUES Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :---------------------------------------------------------------------------- | +|:--------- |:-------- |:----------------------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the recovery information |
@@ -503,14 +503,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_metadata [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :----------------------------------------------------------------- | +|:--------- |:-------- |:------------------------------------------------------------------ | | wallet_id | True | The Wallet ID of the DID wallet for which to get the metadata list |
@@ -546,14 +546,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_pubkey [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :------------------------------------------------------------------ | +|:--------- |:-------- |:------------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the public key |
@@ -585,14 +585,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_recovery_list [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :----------------------------------------------------------------- | +|:--------- |:-------- |:------------------------------------------------------------------ | | wallet_id | True | The Wallet ID of the DID wallet for which to get the recovery list |
@@ -629,14 +629,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_wallet_name [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :------------------------------------------------------- | +|:--------- |:-------- |:-------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet on which to get the name |
@@ -669,14 +669,14 @@ Usage: chia rpc wallet [OPTIONS] did_message_spend [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------------- | :----- | :------- | :-------------------------------------------------------------- | +|:-------------------- |:------ |:-------- |:--------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the DID wallet from which to spend the message | | coin_announcements | LIST | False | A list of coin announcements to include with the spend | | puzzle_announcements | LIST | False | A list of puzzle announcements to include with the spend | @@ -723,14 +723,14 @@ Usage: chia rpc wallet [OPTIONS] did_recovery_spend [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :---------- | :------- | :-------------------------------------------------------------------------------------------------------------- | +|:----------- |:-------- |:--------------------------------------------------------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet to recover | | attest_data | True | A list of attest files to be used for recovery | | pubkey | False | The public key of the wallet to recover. If this is not provided, a temporary public key will be used instead | @@ -1063,14 +1063,14 @@ Usage: chia rpc wallet [OPTIONS] did_set_wallet_name [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :------------------------------------------------------- | +|:--------- |:-------- |:-------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet on which to set the name | | name | True | The new name of the DID wallet | @@ -1125,19 +1125,19 @@ Usage: chia rpc wallet [OPTIONS] did_transfer_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -| :----------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | True | The Wallet ID of the DID wallet to transfer | -| inner_address | True | The address of the inner puzzle to which to transfer the DID | -| fee | False | An optional blockchain fee, in mojos | +| Parameter | Required | Description | +|:-------------------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | True | The Wallet ID of the DID wallet to transfer | +| inner_address | True | The address of the inner puzzle to which to transfer the DID | +| fee | False | An optional blockchain fee, in mojos | | with_recovery_info | False | If `True`, transfer recovery info [Default: `True`] | -| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -1214,14 +1214,14 @@ Usage: chia rpc wallet [OPTIONS] did_update_metadata [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :------------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet for which to update the metadata | | metadata | False | The updated metadata | | fee | False | An optional blockchain fee, in mojos | @@ -1255,19 +1255,19 @@ Usage: chia rpc wallet [OPTIONS] did_update_recovery_ids [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -| :------------------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | True | The Wallet ID of the DID wallet for which to update the recovery IDs | -| new_list | True | The new recovery ID list. Each item from this list will be appended to the existing list | +| Parameter | Required | Description | +|:---------------------------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | True | The Wallet ID of the DID wallet for which to update the recovery IDs | +| new_list | True | The new recovery ID list. Each item from this list will be appended to the existing list | | num_verifications_required | False | Optionally set the number of IDs required for wallet recovery. If not set, then the entire updated list will be required by default | -| fee | False | An optional blockchain fee, in mojos | -| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| fee | False | An optional blockchain fee, in mojos | +| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md index adf581ddbb..23d4dc186b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md @@ -38,7 +38,7 @@ Usage: chia rpc farmer [OPTIONS] get_harvesters [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -99,7 +99,7 @@ Usage: chia rpc farmer [OPTIONS] get_harvesters_summary [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -149,14 +149,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_duplicates [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | +|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -196,14 +196,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_invalid [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | +|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -243,14 +243,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_keys_missing [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | +|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -296,14 +296,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_valid [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | +|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -354,14 +354,14 @@ Usage: chia rpc farmer [OPTIONS] get_pool_login_link [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :---------- | :--------- | :------- | :---------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +|:----------- |:---------- |:-------- |:------------------------------------------------------------------------------------------- | | launcher_id | HEX STRING | True | The launcher_id from your pool, obtainable from the [get_pool_state](#get_pool_state) RPC |
@@ -393,7 +393,7 @@ Usage: chia rpc farmer [OPTIONS] get_pool_state [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -444,6 +444,16 @@ Response: } ], "success": true +} + }, + { + "error_code": 10, + "error_message": "Farmer with launcher_id 55244acf3017c2fc245020b46600827047dce8f54c982adaf95248ff2e955ad8 unknown." + } + ] + } + ], + "success": true } ``` @@ -460,14 +470,14 @@ Usage: chia rpc farmer [OPTIONS] get_reward_targets [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :--------------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +|:------------------------ |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | search_for_private_key | BOOLEAN | True | List whether the private key (sk) is available for both the farmer and pool keys | | max_ph_to_search | INTEGER | False | The maximum number of puzzle hashes to search [Default: 500] If the wallet's derivation index is large, this number may be insufficient to locate the correct puzzle hashes. In this case, you may need to increase this value | @@ -501,7 +511,7 @@ Usage: chia rpc farmer [OPTIONS] get_routes [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -556,14 +566,14 @@ Usage: chia rpc farmer [OPTIONS] get_signage_point [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :--------- | :------- | :------------------------------------------------------------------------------------- | +|:------- |:---------- |:-------- |:-------------------------------------------------------------------------------------- | | sp_hash | HEX STRING | True | The hash of a signage point, listed as `pos_ss_cc_challenge_hash` in the block details |
@@ -603,7 +613,7 @@ Usage: chia rpc farmer [OPTIONS] get_signage_points [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -696,16 +706,16 @@ Usage: chia rpc farmer [OPTIONS] set_payout_instructions [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------ | :--------- | :------- | :---------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +|:------------------- |:---------- |:-------- |:------------------------------------------------------------------------------------------- | | launcher_id | HEX STRING | True | The launcher_id from your pool, obtainable from the [get_pool_state](#get_pool_state) RPC | -| payout_instructions | HEX STRING | True | The puzzle hash to be used as the new `payout_instructions` | +| payout_instructions | HEX STRING | True | The puzzle hash to be used as the new `payout_instructions` |
Example @@ -735,14 +745,14 @@ Usage: chia rpc farmer [OPTIONS] set_reward_targets [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------ | :--------- | :------- | :--------------------------- | +|:------------- |:---------- |:-------- |:---------------------------- | | farmer_target | HEX STRING | False | Set the farmer reward target | | pool_target | HEX STRING | False | Set the pool reward target | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md new file mode 100644 index 0000000000..26000624e8 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md @@ -0,0 +1,3666 @@ +--- +sidebar_label: Full Node +title: Full Node RPC +slug: /full-node-rpc +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +The full node RPC API is exposed by the full node, by default on port 8555. This port must not be exposed publicly for +security concerns. + +A synced full node is required for running the RPCs in this document. + +:::info + +The [coinset CLI tool](https://github.com/coinset-org/cli) is also capable of returning results equivalent to most of these RPCs. It queries a remote full node that is fast and reliable. + +::: + +
+ Note about Windows command escaping + +This document will use Linux/MacOS RPC syntax. When running rpc commands on Windows, you'll need to escape all quotes with backslashes. + +For example, here is a typical RPC command on Linux and MacOS: + +```powershell +chia rpc full_node get_block '{"header_hash":"0xf42b4e77315d79ddfb3d64becb21e26ebff5408bda4d1b7c3782fd04f49ec0bb"}' +``` + +To run the same command on Windows, you need to escape the quotes with backslashes. In other words, add a \ before each double quote, such that: + +``` +`"header_hash"` becomes `\"header_hash\"` +``` + +
+ +--- + +### `get_additions_and_removals` + +Functionality: Retrieves the additions and removals (state transitions) for a certain block. Returns coin records for each addition and removal + +Usage: chia rpc full_node [OPTIONS] get_additions_and_removals [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------- | :--------- | :------- | :--------------------------- | +| header_hash | HEX STRING | True | The header hash of the block | + +:::note + +Blocks that are not transaction blocks will have empty removal and addition lists. To get the actual puzzles and solutions +for spent coins, use the [get_puzzle_and_solution](#get_puzzle_and_solution) API. + +::: + +
+Example + +````mdx-code-block + ```json + chia rpc full_node get_additions_and_removals '{"header_hash": "0xfb7891e9a4a9ca6f8a633e0632d82c2502f425526754f71aee5a55d6ad3933d8"}' + ``` +```` + +Response: + +````mdx-code-block +```json +{ + "additions": [ + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0x9558e5246519b184da7bd9d7bfb528680309352f8658941bfd9452f38d976294", + "puzzle_hash": "0x2f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0x9558e5246519b184da7bd9d7bfb528680309352f8658941bfd9452f38d976294", + "puzzle_hash": "0xbcf5ca4509bcd430a3366c6b261e09b9def74ee7c5a4a3388a56ae9380099bfc" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 82488030982, + "parent_coin_info": "0x7a639649fa2b6b4233cab7bf98b3da01be182afba622eb377011ac0940cd83c8", + "puzzle_hash": "0x5cfe0cf4c19ca813a05c642915bd68a5e99baee39033d0c6d70774296397e249" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0x7a639649fa2b6b4233cab7bf98b3da01be182afba622eb377011ac0940cd83c8", + "puzzle_hash": "0xb5db5e9e2b807d276cfeeed124e2629e1c9ee90cabc209a7469ef13545d120ad" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0xadc1a21da474f751a3235f45ae17a2a97ad28cc8c475842a876685d3cd0419ea", + "puzzle_hash": "0xfd41971c8c4cb5b662f7a1aa49790fa110a0b99f9ada4bb6276a23670cdbb4aa" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xadc1a21da474f751a3235f45ae17a2a97ad28cc8c475842a876685d3cd0419ea", + "puzzle_hash": "0x2f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 82487941066, + "parent_coin_info": "0x727961c5d7febde6ea775bd98aca7461f9c6150599bf726a8ccb5f61e86b1f53", + "puzzle_hash": "0xe0ce2b64138107f8371f83aaef3dabf81c19227268ddc2a8c1238adcb7244794" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0x727961c5d7febde6ea775bd98aca7461f9c6150599bf726a8ccb5f61e86b1f53", + "puzzle_hash": "0xb5db5e9e2b807d276cfeeed124e2629e1c9ee90cabc209a7469ef13545d120ad" + }, + "coinbase": false, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032f4ec", + "puzzle_hash": "0x907491ca39c35bc1f9a6eda33f7c0f97a9f583975088dad7216f1edd79f522ae" + }, + "coinbase": true, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb0000000000000000000000000032f4ec", + "puzzle_hash": "0x907491ca39c35bc1f9a6eda33f7c0f97a9f583975088dad7216f1edd79f522ae" + }, + "coinbase": true, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032f4ea", + "puzzle_hash": "0x6529ccb5c37da2c32b5e0984043969e84254dcccf70459c137f9661f06388e8c" + }, + "coinbase": true, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb0000000000000000000000000032f4eb", + "puzzle_hash": "0x454ead2a2dd42ee0d4c66dff83e1df3d769770010b4890b44883dcad2276aa19" + }, + "coinbase": true, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb0000000000000000000000000032f4ea", + "puzzle_hash": "0x10926349cdd6b3bad8cc66073f52530cd89a237f932c4b5f737f8fe1aa3ec173" + }, + "coinbase": true, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032f4eb", + "puzzle_hash": "0xca240d0ec25d7cadbe0c920e95e6b8011da2e86aaca2959a8bd8fbec97684ddc" + }, + "coinbase": true, + "confirmed_block_index": 3339504, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678082304 + } + ], + "removals": [ + { + "coin": { + "amount": 1, + "parent_coin_info": "0x5112208f031c9c158f3e25f91fe1cd2593251c713393329f53d4f7a438512622", + "puzzle_hash": "0xbcf5ca4509bcd430a3366c6b261e09b9def74ee7c5a4a3388a56ae9380099bfc" + }, + "coinbase": false, + "confirmed_block_index": 3161234, + "spent": true, + "spent_block_index": 3339504, + "timestamp": 1674748162 + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0x5b778e06d75e13265e66169372c4272b1c97eae44ffb72fbe957957b0c341819", + "puzzle_hash": "0xfd41971c8c4cb5b662f7a1aa49790fa110a0b99f9ada4bb6276a23670cdbb4aa" + }, + "coinbase": false, + "confirmed_block_index": 3269008, + "spent": true, + "spent_block_index": 3339504, + "timestamp": 1676766135 + }, + { + "coin": { + "amount": 82487942067, + "parent_coin_info": "0x4c2710fe1401ab8aa1c88d5dd1720dafaac3ffa68c54a67423b5f8e6471278c1", + "puzzle_hash": "0xa500c99239723e078089cfa2f64aa1bb2140b503cb4e940fedeb7b6313096e1c" + }, + "coinbase": false, + "confirmed_block_index": 3339361, + "spent": true, + "spent_block_index": 3339504, + "timestamp": 1678079546 + }, + { + "coin": { + "amount": 82488031983, + "parent_coin_info": "0xfdc7526bfc5107e000b4f710c8c5944f11f4e7ce9711c522b6040bc473266313", + "puzzle_hash": "0x5198fccb3ca8f14c32a5f05ac50c98209defd2d3ed3ee2a17789a9f6fd7d433b" + }, + "coinbase": false, + "confirmed_block_index": 3339400, + "spent": true, + "spent_block_index": 3339504, + "timestamp": 1678080343 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032f4d1", + "puzzle_hash": "0x275544ef0d40a516979d208ac215b306eefddb9675d0bdd08336f06d90f99444" + }, + "coinbase": true, + "confirmed_block_index": 3339476, + "spent": true, + "spent_block_index": 3339504, + "timestamp": 1678081696 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032f4d0", + "puzzle_hash": "0x3ef5a53f9b70a309e1778635d9841c1dbdc9eeaf18e963e619327cf92843879b" + }, + "coinbase": true, + "confirmed_block_index": 3339476, + "spent": true, + "spent_block_index": 3339504, + "timestamp": 1678081696 + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_aggsig_additional_data` + +Functionality: Returns the additional data used for `AGG_SIG` conditions for the current network + +Usage: chia rpc full_node [OPTIONS] get_aggsig_additional_data [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_aggsig_additional_data +``` +```` + +Response: + +````mdx-code-block +```json +{ + "additional_data": "ccd5bb71183532bff220ba46c268991a3ff07eb358e8255a65c30a2dce0e5fbb", + "success": true +} +``` +```` + +
+ +--- + +### `get_all_mempool_items` + +Functionality: Returns all items in the mempool + +Usage: chia rpc full_node [OPTIONS] get_all_mempool_items [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_all_mempool_items +``` +```` + +Response: + +````mdx-code-block +```json +{ + "mempool_items": { + "7a0bc58719ab4268b377fd23278c8bfbae830895f72344a07fa4e96e3df32c7c": { + "additions": [ + { + "amount": 1, + "parent_coin_info": "0x4ab9a26f096d8e3388818668a59d70e9717c6725733a7ac28e330d5ad250ba34", + "puzzle_hash": "0x6518c964407acdf0257f83175116ac160e68e59c953a1bff66e3dc962b770269" + } + ], + "cost": 31796662, + "fee": 0, + "npc_result": { + "conds": { + "agg_sig_unsafe": [], + "before_height_absolute": null, + "before_seconds_absolute": null, + "cost": 31796662, + "height_absolute": 0, + "reserve_fee": 0, + "seconds_absolute": 0, + "spends": [ + { + "agg_sig_me": [ + [ + "0x8f04c6342dbd95e08f77d4d49aefbf130bb9560f3e52e7c61c67f61944982a1469726acaa0900d226440d171fa1a59bd", + "0xcda5e57874cd52a609d3f49fca7db0cf5502375b76317ac57c886dc8cb807ff7" + ] + ], + "before_height_relative": null, + "before_seconds_relative": null, + "coin_id": "0x4ab9a26f096d8e3388818668a59d70e9717c6725733a7ac28e330d5ad250ba34", + "create_coin": [ + [ + "0x6518c964407acdf0257f83175116ac160e68e59c953a1bff66e3dc962b770269", + 1, + null + ] + ], + "flags": 0, + "height_relative": null, + "puzzle_hash": "0x4f2868c836a9fcd66c3d14ea08081137c079c42ed5576fe0d5069551f85ee115", + "seconds_relative": 0 + } + ] + }, + "cost": 31796662, + "error": null + }, + "removals": [ + { + "amount": 1, + "parent_coin_info": "0x538ebc1d1dd243bf838d53084546fe5c2eb2304e0f3525a9c4caa2f2199c2c33", + "puzzle_hash": "0x4f2868c836a9fcd66c3d14ea08081137c079c42ed5576fe0d5069551f85ee115" + } + ], + "spend_bundle": { + "aggregated_signature": "0xb264032b7830dd43cb1156cf33f895ef74e84692a8506f627c8dd776f60766ba2e5e1ddc3537b8c39b0e9a38b2b1fa3f0d07edeb678cf0cbc6f3665737a137cb001ed09d906bd8baacd624f6689d0c6706ce15b7c496e9c151ded5a2fd529cce", + "coin_spends": [ + { + "coin": { + "amount": 1, + "parent_coin_info": "0x538ebc1d1dd243bf838d53084546fe5c2eb2304e0f3525a9c4caa2f2199c2c33", + "puzzle_hash": "0x4f2868c836a9fcd66c3d14ea08081137c079c42ed5576fe0d5069551f85ee115" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fffff010180ffff01ff02ff36ffff04ff02ffff04ff05ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff0bff80808080ffff04ff2fffff04ff0bffff04ff5fff808080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4602ff3304ffff0101ff02ffff02ffff03ff05ffff01ff02ff5cffff04ff02ffff04ff0dffff04ffff0bff2cffff0bff24ff3880ffff0bff2cffff0bff2cffff0bff24ff3480ff0980ffff0bff2cff0bffff0bff24ff8080808080ff8080808080ffff010b80ff0180ff02ffff03ff0bffff01ff02ff32ffff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ffff02ff2affff04ff02ffff04ffff02ffff03ffff09ff23ff2880ffff0181b3ff8080ff0180ff80808080ff80808080808080ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffffff0bffff0bff17ffff02ff3affff04ff02ffff04ff09ffff04ff2fffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ff5f80ff0bff81bf80ff02ffff03ffff20ffff22ff4fff178080ffff01ff02ff7effff04ff02ffff04ff6fffff04ffff04ffff02ffff03ff4fffff01ff04ff23ffff04ffff02ff3affff04ff02ffff04ff09ffff04ff53ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff81b3ff80808080ffff011380ff0180ffff02ff7cffff04ff02ffff04ff05ffff04ff1bffff04ffff21ff4fff1780ff80808080808080ff8080808080ffff01ff088080ff0180ffff04ffff09ffff18ff05ffff010180ffff010180ffff09ff05ffff01818f8080ff0bff2cffff0bff24ff3080ffff0bff2cffff0bff2cffff0bff24ff3480ff0580ffff0bff2cffff02ff5cffff04ff02ffff04ff07ffff04ffff0bff24ff2480ff8080808080ffff0bff24ff8080808080ffffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff26ffff04ff02ffff04ff09ff80808080ffff02ff26ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ff5effff04ff02ffff04ff05ffff04ff0bffff04ffff02ff3affff04ff02ffff04ff09ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfff80808080808080808080ffff04ffff04ff20ffff04ff17ff808080ffff02ff7cffff04ff02ffff04ff05ffff04ffff02ff82017fffff04ffff04ffff04ff17ff2f80ffff04ffff04ff5fff81bf80ffff04ff0bff05808080ff8202ff8080ffff01ff80808080808080ffff02ff2effff04ff02ffff04ff05ffff04ff0bffff04ffff02ffff03ff3bffff01ff02ff22ffff04ff02ffff04ff05ffff04ff17ffff04ff13ffff04ff2bffff04ff5bffff04ff5fff808080808080808080ffff01ff02ffff03ffff09ff15ffff0bff13ff1dff2b8080ffff01ff0bff15ff17ff5f80ffff01ff088080ff018080ff0180ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfffff04ff82017fff8080808080808080808080ff02ffff03ff05ffff011bffff010b80ff0180ff018080ffff04ffff01ffa024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffa0e10b98373faad996cf868f03e736376135a50281ebfbe9778dff6cc11470bb8ca0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff8202ffffff01ff02ff16ffff04ff02ffff04ff05ffff04ff8204bfffff04ff8206bfffff04ff82017fffff04ffff0bffff19ff2fffff18ffff019100ffffffffffffffffffffffffffffffffff8202ff8080ff0bff82017f80ff8080808080808080ffff01ff04ffff04ff08ffff04ff17ffff04ffff02ff1effff04ff02ffff04ff82017fff80808080ff80808080ffff04ffff04ff1cffff04ff5fffff04ff8206bfff80808080ff80808080ff0180ffff04ffff01ffff32ff3d33ff3effff04ffff04ff1cffff04ff0bffff04ff17ff80808080ffff04ffff04ff1cffff04ff05ffff04ff2fff80808080ffff04ffff04ff0affff04ff5fff808080ffff04ffff04ff14ffff04ffff0bff5fffff012480ff808080ff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a02f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57ffff04ffff01a0e4e875f19e52f45465026aa60728e45047a576c3c4763198e18d3e0b03d3d048ffff04ffff01b08f04c6342dbd95e08f77d4d49aefbf130bb9560f3e52e7c61c67f61944982a1469726acaa0900d226440d171fa1a59bdffff04ffff01a0ccd5bb71183532bff220ba46c268991a00000000000000000000000000000000ffff04ffff01a0bc2fb2044e0f54b2c43ae0dacd9b5b8b1aeb29f8083de0ae432ab28e551c002cff01808080808080ff01808080", + "solution": "0xffffa0dca1909d42fbbff75d8504bacec6e38345f8e7893934cb557dbed1d47bb9b740ffa09acf597a1a2c76dcdbada7f6ee21225bf7b50c51fa3e587f3861cffd21fd365bff0180ff01ffffffff70c07301022f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d578f04c6342dbd95e08f77d4d49aefbf130bb9560f3e52e7c61c67f61944982a1469726acaa0900d226440d171fa1a59bd010000001868747470733a2f2f61736961312e706f6f6c2e73706163650000004080ff808080" + } + ] + }, + "spend_bundle_name": "0x7a0bc58719ab4268b377fd23278c8bfbae830895f72344a07fa4e96e3df32c7c" + }, + "c029700735f3bc77a40c01a75d8a04818552ef0a71320105c8621810220c156c": { + "additions": [ + { + "amount": 1, + "parent_coin_info": "0x3da90280d9f997f229161598fe0c9162bcc77d0e3a632f9c074b22b8fbd1585b", + "puzzle_hash": "0xfd22a811575a18f7970dd2ee8980dc66278dfe74c5d454721dae9679ea130d03" + }, + { + "amount": 7888, + "parent_coin_info": "0x3da90280d9f997f229161598fe0c9162bcc77d0e3a632f9c074b22b8fbd1585b", + "puzzle_hash": "0xa6a570bae50e46957f74260a6537e9db5c01546842fb7211fb2c8528cdce917b" + } + ], + "cost": 38698534, + "fee": 0, + "npc_result": { + "conds": { + "agg_sig_unsafe": [], + "before_height_absolute": null, + "before_seconds_absolute": null, + "cost": 38698534, + "height_absolute": 0, + "reserve_fee": 0, + "seconds_absolute": 0, + "spends": [ + { + "agg_sig_me": [ + [ + "0xa2eaa8627d7ec6f936eba6b14a139c7e64e688c044041054e7fbe1cdfcc63334fcf16d6be0dd10e1ffd0c0bbcbf7048e", + "0x278bec5c6e5e9279bcb342a900a08945e7a06bc27fe6f2b182d143d9fe08f5ce" + ] + ], + "before_height_relative": null, + "before_seconds_relative": null, + "coin_id": "0x3da90280d9f997f229161598fe0c9162bcc77d0e3a632f9c074b22b8fbd1585b", + "create_coin": [ + [ + "0xfd22a811575a18f7970dd2ee8980dc66278dfe74c5d454721dae9679ea130d03", + 1, + "0x42abe0e28c18d0e7b30519586ca64f9388d55902d6836e724105a01d46204369" + ], + [ + "0xa6a570bae50e46957f74260a6537e9db5c01546842fb7211fb2c8528cdce917b", + 7888, + null + ] + ], + "flags": 0, + "height_relative": null, + "puzzle_hash": "0xa9d5baa58734a7b7ad5d0dcc8c6f938c5a202a5c951a1124a01527d7cb391686", + "seconds_relative": 0 + } + ] + }, + "cost": 38698534, + "error": null + }, + "removals": [ + { + "amount": 7889, + "parent_coin_info": "0xb0947ccc422de910408c51ea3e14ea9b069ed77b0559f98ebd604a767cb5fde4", + "puzzle_hash": "0xa9d5baa58734a7b7ad5d0dcc8c6f938c5a202a5c951a1124a01527d7cb391686" + } + ], + "spend_bundle": { + "aggregated_signature": "0x97dacfc6c718114654774d0b3e84b59343d7ee795aa9a15cff95daba79b04415ebccac9ba384c3362c62dc7596d9c4ea1177694a230f394314ddeed5f430a0b0999984c8cbf52f8bfad5dcf535e8b473b0b05cfa56ebbd6fbb0ee04af368b5e4", + "coin_spends": [ + { + "coin": { + "amount": 7889, + "parent_coin_info": "0xb0947ccc422de910408c51ea3e14ea9b069ed77b0559f98ebd604a767cb5fde4", + "puzzle_hash": "0xa9d5baa58734a7b7ad5d0dcc8c6f938c5a202a5c951a1124a01527d7cb391686" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ff5effff04ff02ffff04ffff04ff05ffff04ffff0bff34ff0580ffff04ff0bff80808080ffff04ffff02ff17ff2f80ffff04ff5fffff04ffff02ff2effff04ff02ffff04ff17ff80808080ffff04ffff02ff2affff04ff02ffff04ff82027fffff04ff82057fffff04ff820b7fff808080808080ffff04ff81bfffff04ff82017fffff04ff8202ffffff04ff8205ffffff04ff820bffff80808080808080808080808080ffff04ffff01ffffffff3d46ff02ff333cffff0401ff01ff81cb02ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff7cffff0bff34ff2480ffff0bff7cffff0bff7cffff0bff34ff2c80ff0980ffff0bff7cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ffff02ffff03ff0bffff01ff02ffff03ffff09ffff02ff2effff04ff02ffff04ff13ff80808080ff820b9f80ffff01ff02ff56ffff04ff02ffff04ffff02ff13ffff04ff5fffff04ff17ffff04ff2fffff04ff81bfffff04ff82017fffff04ff1bff8080808080808080ffff04ff82017fff8080808080ffff01ff088080ff0180ffff01ff02ffff03ff17ffff01ff02ffff03ffff20ff81bf80ffff0182017fffff01ff088080ff0180ffff01ff088080ff018080ff0180ff04ffff04ff05ff2780ffff04ffff10ff0bff5780ff778080ffffff02ffff03ff05ffff01ff02ffff03ffff09ffff02ffff03ffff09ff11ff5880ffff0159ff8080ff0180ffff01818f80ffff01ff02ff26ffff04ff02ffff04ff0dffff04ff0bffff04ffff04ff81b9ff82017980ff808080808080ffff01ff02ff7affff04ff02ffff04ffff02ffff03ffff09ff11ff5880ffff01ff04ff58ffff04ffff02ff76ffff04ff02ffff04ff13ffff04ff29ffff04ffff0bff34ff5b80ffff04ff2bff80808080808080ff398080ffff01ff02ffff03ffff09ff11ff7880ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0121ffff0dff298080ffff01ff02ffff03ffff09ffff0cff29ff80ff3480ff5c80ffff01ff0101ff8080ff0180ff8080ff018080ffff0109ffff01ff088080ff0180ffff010980ff018080ff0180ffff04ffff02ffff03ffff09ff11ff5880ffff0159ff8080ff0180ffff04ffff02ff26ffff04ff02ffff04ff0dffff04ff0bffff04ff17ff808080808080ff80808080808080ff0180ffff01ff04ff80ffff04ff80ff17808080ff0180ffff02ffff03ff05ffff01ff04ff09ffff02ff56ffff04ff02ffff04ff0dffff04ff0bff808080808080ffff010b80ff0180ff0bff7cffff0bff34ff2880ffff0bff7cffff0bff7cffff0bff34ff2c80ff0580ffff0bff7cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ffff04ffff04ff30ffff04ff5fff808080ffff02ff7effff04ff02ffff04ffff04ffff04ff2fff0580ffff04ff5fff82017f8080ffff04ffff02ff26ffff04ff02ffff04ff0bffff04ff05ffff01ff808080808080ffff04ff17ffff04ff81bfffff04ff82017fffff04ffff02ff2affff04ff02ffff04ff8204ffffff04ffff02ff76ffff04ff02ffff04ff09ffff04ff820affffff04ffff0bff34ff2d80ffff04ff15ff80808080808080ffff04ff8216ffff808080808080ffff04ff8205ffffff04ff820bffff808080808080808080808080ff02ff5affff04ff02ffff04ff5fffff04ff3bffff04ffff02ffff03ff17ffff01ff09ff2dffff02ff2affff04ff02ffff04ff27ffff04ffff02ff76ffff04ff02ffff04ff29ffff04ff57ffff04ffff0bff34ff81b980ffff04ff59ff80808080808080ffff04ff81b7ff80808080808080ff8080ff0180ffff04ff17ffff04ff05ffff04ff8202ffffff04ffff04ffff04ff78ffff04ffff0eff5cffff02ff2effff04ff02ffff04ffff04ff2fffff04ff82017fff808080ff8080808080ff808080ffff04ffff04ff20ffff04ffff0bff81bfff5cffff02ff2effff04ff02ffff04ffff04ff15ffff04ffff10ff82017fffff11ff8202dfff2b80ff8202ff80ff808080ff8080808080ff808080ff138080ff80808080808080808080ff018080ffff04ffff01a037bef360ee858133b69d595a906dc45d01af50379dad515eb9518abb7c1d2a7affff04ffff01a0ec25b77bc54df637392d6a0f542de65f45020405d0f36ced723bff2870c378b1ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a2eaa8627d7ec6f936eba6b14a139c7e64e688c044041054e7fbe1cdfcc63334fcf16d6be0dd10e1ffd0c0bbcbf7048eff018080ff0180808080", + "solution": "0xffff80ffff01ffff33ffa042abe0e28c18d0e7b30519586ca64f9388d55902d6836e724105a01d46204369ff01ffffa042abe0e28c18d0e7b30519586ca64f9388d55902d6836e724105a01d462043698080ffff33ffa05b052e7f4dec88c750ae357d97043324361ded7471bba1cd4e723a0bb6c2bae3ff821ed080ffff3cffa0e915e5c9f1d19f53a644ef0eeeb0bb277f15ffed97ecca9371ecdb9971c528b28080ff8080ffffa0058ccbaf11089e205e92b53dd78728bf5b3da5e149046b70a34be0b4695b8d76ffa0e18d1f4a1660e626c0857ae687191d8bddfa60b79a45d9ec3dae366b23256a47ff821ed280ffa03da90280d9f997f229161598fe0c9162bcc77d0e3a632f9c074b22b8fbd1585bffffa0b0947ccc422de910408c51ea3e14ea9b069ed77b0559f98ebd604a767cb5fde4ffa0a9d5baa58734a7b7ad5d0dcc8c6f938c5a202a5c951a1124a01527d7cb391686ff821ed180ffffa0b0947ccc422de910408c51ea3e14ea9b069ed77b0559f98ebd604a767cb5fde4ffa04804b6a94dca8278af122b8b17de77f43b05a1bc9d1d0af31757bf078ff5e9b3ff821ed180ff80ff8080" + } + ] + }, + "spend_bundle_name": "0xc029700735f3bc77a40c01a75d8a04818552ef0a71320105c8621810220c156c" + }, + "cc59cca8026c95d289decfe7125f8ca51fdfcbe05ff7d4cab7a413d8af457b75": { + "additions": [ + { + "amount": 322132010850357, + "parent_coin_info": "0x9fc0589841a26b8c2235dbe08665e5ff974ce60b1c6272908818a2219a3f2bab", + "puzzle_hash": "0x744ca58515729a01de90a53cfb3c1d7f0d3476400d334a71f5fd916ff611b303" + }, + { + "amount": 57653040000, + "parent_coin_info": "0x9fc0589841a26b8c2235dbe08665e5ff974ce60b1c6272908818a2219a3f2bab", + "puzzle_hash": "0x77fd0397f735deba4b983ad0f0cc0d56d33a0f6782638cc8309b427c3c47c84a" + } + ], + "cost": 11082050, + "fee": 1, + "npc_result": { + "conds": { + "agg_sig_unsafe": [], + "before_height_absolute": null, + "before_seconds_absolute": null, + "cost": 11082050, + "height_absolute": 0, + "reserve_fee": 1, + "seconds_absolute": 0, + "spends": [ + { + "agg_sig_me": [ + [ + "0xaec94d64c804b1d2cb448c8d13d4e43da81b9edceab5cc63c18bd2bbe9d4d28600e868f17c724cd674b9bf471e2ca518", + "0x031907d28a5a7aa37b0ddf06629736be35bb3c7ed0e62c196466fa25a1bf425d" + ] + ], + "before_height_relative": null, + "before_seconds_relative": null, + "coin_id": "0x9fc0589841a26b8c2235dbe08665e5ff974ce60b1c6272908818a2219a3f2bab", + "create_coin": [ + [ + "0x744ca58515729a01de90a53cfb3c1d7f0d3476400d334a71f5fd916ff611b303", + 322132010850357, + null + ], + [ + "0x77fd0397f735deba4b983ad0f0cc0d56d33a0f6782638cc8309b427c3c47c84a", + 57653040000, + null + ] + ], + "flags": 0, + "height_relative": null, + "puzzle_hash": "0x744ca58515729a01de90a53cfb3c1d7f0d3476400d334a71f5fd916ff611b303", + "seconds_relative": 0 + } + ] + }, + "cost": 11082050, + "error": null + }, + "removals": [ + { + "amount": 322189663890358, + "parent_coin_info": "0xa338f1f747fb711754c11fcff8825ceafd2cee960d7916d606668747f69e589c", + "puzzle_hash": "0x744ca58515729a01de90a53cfb3c1d7f0d3476400d334a71f5fd916ff611b303" + } + ], + "spend_bundle": { + "aggregated_signature": "0xa781b277687545599228d2bbc91c75ffbcd467ca0acd71e4a6182d21bba0c71a525f44d9cc807577ac7a3a38b361bb8619007342c47fa33b60d4daaf778991c906a512d50e8382fa3239309e97eb0e6bda7ba37f188215b4884e3fd5426a6f2e", + "coin_spends": [ + { + "coin": { + "amount": 322189663890358, + "parent_coin_info": "0xa338f1f747fb711754c11fcff8825ceafd2cee960d7916d606668747f69e589c", + "puzzle_hash": "0x744ca58515729a01de90a53cfb3c1d7f0d3476400d334a71f5fd916ff611b303" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec94d64c804b1d2cb448c8d13d4e43da81b9edceab5cc63c18bd2bbe9d4d28600e868f17c724cd674b9bf471e2ca518ff018080", + "solution": "0xff80ffff01ffff33ffa0744ca58515729a01de90a53cfb3c1d7f0d3476400d334a71f5fd916ff611b303ff870124fa3413d83580ffff33ffa077fd0397f735deba4b983ad0f0cc0d56d33a0f6782638cc8309b427c3c47c84aff850d6c63938080ffff34ff0180ffff3cffa03d3e59df11f0fa11ea3ae7f251fc2430374f0e57afec9968720796f819bc0edb8080ff8080" + } + ] + }, + "spend_bundle_name": "0xcc59cca8026c95d289decfe7125f8ca51fdfcbe05ff7d4cab7a413d8af457b75" + }, + "d9bf060978afd797d35026ceb33886b030757735990fe0f03791fec3e695bbda": { + "additions": [ + { + "amount": 134290334, + "parent_coin_info": "0x58d060da1c0300bf36d61735d2bc2294359f7260ce9bd12e17a019d7c6374bad", + "puzzle_hash": "0xd38ecedf2f4eb3efecfd7e0fd354f2424e31243198a8d8778dab39a1582edda5" + }, + { + "amount": 173918, + "parent_coin_info": "0x58d060da1c0300bf36d61735d2bc2294359f7260ce9bd12e17a019d7c6374bad", + "puzzle_hash": "0x56298e0b6af9ab382d4fc1ef18912ab472c3a6a85870ab179d5209d4dc00634c" + }, + { + "amount": 45461, + "parent_coin_info": "0x38f5974f59964e5ef86c0ec874e36a33c03a41605260366443dbcd115243349e", + "puzzle_hash": "0x271fb64316ed2bb6504097835d19bf382b3b5d6a761ca65290f2c05fb9c5cf06" + } + ], + "cost": 48568311, + "fee": 1, + "npc_result": { + "conds": { + "agg_sig_unsafe": [], + "before_height_absolute": null, + "before_seconds_absolute": null, + "cost": 48568311, + "height_absolute": 0, + "reserve_fee": 1, + "seconds_absolute": 0, + "spends": [ + { + "agg_sig_me": [ + [ + "0xac23a0d79b791f2ffea4d1ea96911c85dbd0b69c43fae4a2f778bea0f950b185fd97157414c72b1b4da9f39e8c7ef3be", + "0xd90f4e1eb999ee79ba276b44d20a334f5fffd2c678902e03a3e369c55d0c8111" + ] + ], + "before_height_relative": null, + "before_seconds_relative": null, + "coin_id": "0x58d060da1c0300bf36d61735d2bc2294359f7260ce9bd12e17a019d7c6374bad", + "create_coin": [ + [ + "0xd38ecedf2f4eb3efecfd7e0fd354f2424e31243198a8d8778dab39a1582edda5", + 134290334, + null + ], + [ + "0x56298e0b6af9ab382d4fc1ef18912ab472c3a6a85870ab179d5209d4dc00634c", + 173918, + "0xe5f45c3e37fbc0c8ca712809279e20976d662661f36165072d0c5a2a75d7a98e" + ] + ], + "flags": 0, + "height_relative": null, + "puzzle_hash": "0x40cbca857d77ac3eccad93398c218caf85a4801020ae8d8e4730bd5d438d554a", + "seconds_relative": 0 + }, + { + "agg_sig_me": [ + [ + "0xa479ea5e9bfdf1da07521313e4a767dffb566aada757ca914ccfc00b2e832a1c497f0e5f70ebb795aed7cb96361e08b5", + "0xd1768f28d4790bbe1ae45c2ddbc3e80c3b38238d66839e618c18a8bb28d679f0" + ] + ], + "before_height_relative": null, + "before_seconds_relative": null, + "coin_id": "0x38f5974f59964e5ef86c0ec874e36a33c03a41605260366443dbcd115243349e", + "create_coin": [ + [ + "0x271fb64316ed2bb6504097835d19bf382b3b5d6a761ca65290f2c05fb9c5cf06", + 45461, + null + ] + ], + "flags": 0, + "height_relative": null, + "puzzle_hash": "0xa35c1e2f5670c8577a6cb6d65560e573fb09b3c98ce9c588e413791700ecfd14", + "seconds_relative": 0 + } + ] + }, + "cost": 48568311, + "error": null + }, + "removals": [ + { + "amount": 134464252, + "parent_coin_info": "0x619fed74492b0ca70616156bec92202ed20ef79cb35b6e799ed98b2a896bf47e", + "puzzle_hash": "0x40cbca857d77ac3eccad93398c218caf85a4801020ae8d8e4730bd5d438d554a" + }, + { + "amount": 45462, + "parent_coin_info": "0xe52a976f3c5569f81abde873bb3337627498ad46db5bb6f8741a14bb8779ac93", + "puzzle_hash": "0xa35c1e2f5670c8577a6cb6d65560e573fb09b3c98ce9c588e413791700ecfd14" + } + ], + "spend_bundle": { + "aggregated_signature": "0x80b0d6c2ce8e970c1269331f497d71304de1cb0c7efa94d0f345f3ac63f0960415d001d86a113631fc6ca2745d79803e122fad9ea72d5a11feee4f0a0fc4b9267acf48a3c8fe7e94f2ddeffe2dfc6c44818852821814ee5374b49f150f2176d1", + "coin_spends": [ + { + "coin": { + "amount": 134464252, + "parent_coin_info": "0x619fed74492b0ca70616156bec92202ed20ef79cb35b6e799ed98b2a896bf47e", + "puzzle_hash": "0x40cbca857d77ac3eccad93398c218caf85a4801020ae8d8e4730bd5d438d554a" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ff5effff04ff02ffff04ffff04ff05ffff04ffff0bff34ff0580ffff04ff0bff80808080ffff04ffff02ff17ff2f80ffff04ff5fffff04ffff02ff2effff04ff02ffff04ff17ff80808080ffff04ffff02ff2affff04ff02ffff04ff82027fffff04ff82057fffff04ff820b7fff808080808080ffff04ff81bfffff04ff82017fffff04ff8202ffffff04ff8205ffffff04ff820bffff80808080808080808080808080ffff04ffff01ffffffff3d46ff02ff333cffff0401ff01ff81cb02ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff7cffff0bff34ff2480ffff0bff7cffff0bff7cffff0bff34ff2c80ff0980ffff0bff7cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ffff02ffff03ff0bffff01ff02ffff03ffff09ffff02ff2effff04ff02ffff04ff13ff80808080ff820b9f80ffff01ff02ff56ffff04ff02ffff04ffff02ff13ffff04ff5fffff04ff17ffff04ff2fffff04ff81bfffff04ff82017fffff04ff1bff8080808080808080ffff04ff82017fff8080808080ffff01ff088080ff0180ffff01ff02ffff03ff17ffff01ff02ffff03ffff20ff81bf80ffff0182017fffff01ff088080ff0180ffff01ff088080ff018080ff0180ff04ffff04ff05ff2780ffff04ffff10ff0bff5780ff778080ffffff02ffff03ff05ffff01ff02ffff03ffff09ffff02ffff03ffff09ff11ff5880ffff0159ff8080ff0180ffff01818f80ffff01ff02ff26ffff04ff02ffff04ff0dffff04ff0bffff04ffff04ff81b9ff82017980ff808080808080ffff01ff02ff7affff04ff02ffff04ffff02ffff03ffff09ff11ff5880ffff01ff04ff58ffff04ffff02ff76ffff04ff02ffff04ff13ffff04ff29ffff04ffff0bff34ff5b80ffff04ff2bff80808080808080ff398080ffff01ff02ffff03ffff09ff11ff7880ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0121ffff0dff298080ffff01ff02ffff03ffff09ffff0cff29ff80ff3480ff5c80ffff01ff0101ff8080ff0180ff8080ff018080ffff0109ffff01ff088080ff0180ffff010980ff018080ff0180ffff04ffff02ffff03ffff09ff11ff5880ffff0159ff8080ff0180ffff04ffff02ff26ffff04ff02ffff04ff0dffff04ff0bffff04ff17ff808080808080ff80808080808080ff0180ffff01ff04ff80ffff04ff80ff17808080ff0180ffff02ffff03ff05ffff01ff04ff09ffff02ff56ffff04ff02ffff04ff0dffff04ff0bff808080808080ffff010b80ff0180ff0bff7cffff0bff34ff2880ffff0bff7cffff0bff7cffff0bff34ff2c80ff0580ffff0bff7cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ffff04ffff04ff30ffff04ff5fff808080ffff02ff7effff04ff02ffff04ffff04ffff04ff2fff0580ffff04ff5fff82017f8080ffff04ffff02ff26ffff04ff02ffff04ff0bffff04ff05ffff01ff808080808080ffff04ff17ffff04ff81bfffff04ff82017fffff04ffff02ff2affff04ff02ffff04ff8204ffffff04ffff02ff76ffff04ff02ffff04ff09ffff04ff820affffff04ffff0bff34ff2d80ffff04ff15ff80808080808080ffff04ff8216ffff808080808080ffff04ff8205ffffff04ff820bffff808080808080808080808080ff02ff5affff04ff02ffff04ff5fffff04ff3bffff04ffff02ffff03ff17ffff01ff09ff2dffff02ff2affff04ff02ffff04ff27ffff04ffff02ff76ffff04ff02ffff04ff29ffff04ff57ffff04ffff0bff34ff81b980ffff04ff59ff80808080808080ffff04ff81b7ff80808080808080ff8080ff0180ffff04ff17ffff04ff05ffff04ff8202ffffff04ffff04ffff04ff78ffff04ffff0eff5cffff02ff2effff04ff02ffff04ffff04ff2fffff04ff82017fff808080ff8080808080ff808080ffff04ffff04ff20ffff04ffff0bff81bfff5cffff02ff2effff04ff02ffff04ffff04ff15ffff04ffff10ff82017fffff11ff8202dfff2b80ff8202ff80ff808080ff8080808080ff808080ff138080ff80808080808080808080ff018080ffff04ffff01a037bef360ee858133b69d595a906dc45d01af50379dad515eb9518abb7c1d2a7affff04ffff01a01dadf5b097d2e1257d375759aaa15298ed3e0f70b6de275d9c70dc2f7eca14a8ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0ac23a0d79b791f2ffea4d1ea96911c85dbd0b69c43fae4a2f778bea0f950b185fd97157414c72b1b4da9f39e8c7ef3beff018080ff0180808080", + "solution": "0xffff80ffff01ffff33ffa0e5f45c3e37fbc0c8ca712809279e20976d662661f36165072d0c5a2a75d7a98eff8302a75effffa0e5f45c3e37fbc0c8ca712809279e20976d662661f36165072d0c5a2a75d7a98eff4dff61ff72ff6dff6fff74ff73ff2eff69ff6fff20ff52ff65ff67ff75ff6cff61ff72ff20ff50ff61ff79ff6fff75ff748080ffff33ffa0f771516fe3f6e4c1e6a2c6b27c2540e1af2cd608bef5f897c0d49b32114914b0ff8408011b9e80ffff3cffa067380aef1ec583dd56304a1b5a27db95e5e054d536e9b75e25470e58f282cc9e8080ff8080ffffa03d10bab2a504924751169af5966e0fa72f60084bb93d1d4900c2de6ebce3a595ffa0863f63eea4a82717c0e5071350c9a5ecd255e1e836f993685854216757e16d0cff840805f89a80ffa058d060da1c0300bf36d61735d2bc2294359f7260ce9bd12e17a019d7c6374badffffa0619fed74492b0ca70616156bec92202ed20ef79cb35b6e799ed98b2a896bf47effa040cbca857d77ac3eccad93398c218caf85a4801020ae8d8e4730bd5d438d554aff840803c2fc80ffffa0619fed74492b0ca70616156bec92202ed20ef79cb35b6e799ed98b2a896bf47effa0e7cbcad872f4c3d96637423b45a101b43ee199ec35ad9b28b7886517460e128dff840803c2fc80ff80ff8080" + }, + { + "coin": { + "amount": 45462, + "parent_coin_info": "0xe52a976f3c5569f81abde873bb3337627498ad46db5bb6f8741a14bb8779ac93", + "puzzle_hash": "0xa35c1e2f5670c8577a6cb6d65560e573fb09b3c98ce9c588e413791700ecfd14" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a479ea5e9bfdf1da07521313e4a767dffb566aada757ca914ccfc00b2e832a1c497f0e5f70ebb795aed7cb96361e08b5ff018080", + "solution": "0xff80ffff01ffff33ffa0271fb64316ed2bb6504097835d19bf382b3b5d6a761ca65290f2c05fb9c5cf06ff8300b19580ffff34ff0180ffff3cffa05e5e11c7beafaeb57589000532dca89fa2994105ef20c8607a21ce05198eee6880ffff3dffa0f7af688eada984c7c1be8ab93dd4c1f807f155587d9a126ba9dd543f5911dad88080ff8080" + } + ] + }, + "spend_bundle_name": "0xd9bf060978afd797d35026ceb33886b030757735990fe0f03791fec3e695bbda" + } + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_all_mempool_tx_ids` + +Functionality: Returns a list of all transaction IDs (spend bundle hashes) in the mempool + +Usage: chia rpc full_node [OPTIONS] get_all_mempool_tx_ids [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_all_mempool_tx_ids +``` +```` + +Response: + +````mdx-code-block +```json +{ + "success": true, + "tx_ids": [ + "0xcde95bf9f0630d96d7b13b0ec7bb4251e06e407307f68e01c158a3ce2d903df6", + "0x27d6e2390cc810ed8953089a76b79b04b5088e3b7c0f974e1a266d964eb67501", + "0xebc444de2e43d151a7c9d8c1db081ce19780c07e07c334fb448955a401ee96a4", + "0x0daaa1be38c96019df8de5e345dcd1a1423c383a1fcb54e64ff0f994604d3c4b", + "0x75a561a1bf3e2fc26ebdcfc37592c18e228d25486f4f7874a228fbd2aa935b1a" + ] +} +``` +```` + +
+ +--- + +### `get_block` + +Functionality: Retrieves an entire block as a Full Block by header hash + +Usage: chia rpc full_node [OPTIONS] get_block [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------- | :--------- | :------- | :------------------------------------------------------------------------------------- | +| header_hash | HEX STRING | True | Header hash (block identifier) of the block to get. | + +
+Example + +Note that some blocks (such as the one from this example) are not transaction blocks: + +````mdx-code-block +```json +chia rpc full_node get_block '{"header_hash":"0xf42b4e77315d79ddfb3d64becb21e26ebff5408bda4d1b7c3782fd04f49ec0bb"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "block": { + "challenge_chain_ip_proof": { + "normalized_to_identity": true, + "witness": "0x02008cee5f66cd352a6bb56c6e6095a4ee4fecc11918ce42b559f00f7104704d30075519110d6b144e32315c6808a59561790a3c0c6604ee722fc62cb3c130b94733b119915f2b0c544c900646c5e1837adf8beec05c9aad3bd46140d22e256fab090100", + "witness_type": 0 + }, + "challenge_chain_sp_proof": null, + "finished_sub_slots": [], + "foliage": { + "foliage_block_data": { + "extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9", + "farmer_reward_puzzle_hash": "0xe2f70baf739bdaf59e360d3a3e2d4ff8cb89f150d9b60b8e91b870e41b58f2fa", + "pool_signature": null, + "pool_target": { + "max_height": 0, + "puzzle_hash": "0x71afdce401a0f2a6f03de6287902eacfa38502d6667b04da36e32c3930171ce4" + }, + "unfinished_reward_block_hash": "0x293f38e7932dce9e8216820baf873c76836c8ffeb9ef24549a653f2c77a948d0" + }, + "foliage_block_data_signature": "0x81fbc2b4d7d18e85db97e83f254ba6546cb08c80f50de1c7353d20a07d574d0d1c084273a1ef4822e164be450abb2dfe133e7d2d90727a43baae9ad858765b30eea9afaf809563760a07dc3fce343222af857b9af5f4d37f79a832e32f335335", + "foliage_transaction_block_hash": null, + "foliage_transaction_block_signature": null, + "prev_block_hash": "0x902ca8dfdd08e79dec3c96837f4e99162508ffaeff730c68af1fde9b86cbf61b", + "reward_block_hash": "0x5566434842f375434f9a558a3de5907db44903036c3de1573852afffbd1991bd" + }, + "foliage_transaction_block": null, + "infused_challenge_chain_ip_proof": null, + "reward_chain_block": { + "challenge_chain_ip_vdf": { + "challenge": "0xed35c7dd67371857123344c847339e4d23dfa815ba8859d160813a228fc6fc22", + "number_of_iterations": 7242534, + "output": { + "data": "0x01001ea29503859966e59024fb3a903e424a1652e724483b86928febca5e308d7039b7138847e436e5f1ba5f6c025f6c6ff275c070149079877463aa077f571d0706516723eaa51113c8ec624a005dc73704fcccefa26bb0eefbb9af15eb5c61b6090201" + } + }, + "challenge_chain_sp_signature": "0xa8aeaba8b70ad7515055ab8c19d611226718f3bcd3311743a8e247fed59e069095514c68ba5862b186f9854089c27a3a19c45b91d2aebb21267b27268850cc220e1d33fc0e4c582e1602c968c2d58c5c629032ce7da2683a9ed651df729c07d0", + "challenge_chain_sp_vdf": null, + "height": 914661, + "infused_challenge_chain_ip_vdf": null, + "is_transaction_block": false, + "pos_ss_cc_challenge_hash": "0xed35c7dd67371857123344c847339e4d23dfa815ba8859d160813a228fc6fc22", + "proof_of_space": { + "challenge": "0xad43c12b5c5a480ee93992697bd8c9153d536007b0ffac024341cd8ca853a9e3", + "plot_public_key": "0x8b5f3cd22bf5073e12f285d2a0e9bbfb485fea8f3ede2f5573e44168fadbb91b71cef1dffc03758a5241c47b105df81a", + "pool_contract_puzzle_hash": "0x71afdce401a0f2a6f03de6287902eacfa38502d6667b04da36e32c3930171ce4", + "pool_public_key": null, + "proof": "0xa84606d3dba86cbc1c2f56d05175bbbcb970629380bec5c49ad46f0c5f067e4ba74101ac24f0e09fb73ce0ebc9249436c528b5fab689d94c4213072e2acfc1c3a6f17763b16304234002ce471da4ce7e888e2f5abadf4d7f48cd157294ce03cb28df0f45597ca5460cd66c772c7650f2d170d08a5898fe65623b33aac864f44d2a39bcf074e62866edccf9b424f9a8ca56c9a98e87d48fb02b933af951284d610ff1eb71e730a05c2f6c7be86fd4df7efb26e8fb2e573981d8ad866adc02a82ffb0d7ff106c9c78f9cea08f4a2de9db2607266edf6e807924edf9af0f36b8938d97865072126011b67646b4d0e206b706d3a3e67e8862cb0502520f1ad1b4341", + "size": 32 + }, + "reward_chain_ip_vdf": { + "challenge": "0x316979467849d4f8ed3a962e773b0849bdfb4e02861191b5af36f270008b66f9", + "number_of_iterations": 6791425, + "output": { + "data": "0x0300854ebbccc4b4b5c0e0244dab12ada16568da6173b1dee587e0e8a212dacc66e562289358af482e1684f4bbe8b51fe96159ec2ad40a0758ff34e8be54bb63ba16399eb171ffce04ed6ffa5f532dfa0c9c779580f5daafff0d97e0c30ae22077060100" + } + }, + "reward_chain_sp_signature": "0xa81d4d596f4f657e7405eccbe99652eec386f624855b1e0dbd2bdccbc5c909572570daf173da11e26370cb00731ddda611a931eb67d03a3d9f286c704742fc5a4d3fdfb8f6b04ba960debf118e07effa5f030c688dbccb820718661ff8fe7e8a", + "reward_chain_sp_vdf": null, + "signage_point_index": 0, + "total_iters": 3330271511334, + "weight": 1393823840 + }, + "reward_chain_ip_proof": { + "normalized_to_identity": false, + "witness": "0x000005d3ec00e8927763e6782b80784547a215431ab10a0a0c9d3391a6e4583baf546c6b921bd3396d21a949dc187c1a1d0496f81a91b8716688f775cd425d3adc0717232b677b10807f112b7903ffe7dd8f730af4f4e942a2713322b3c2dda0b42b0100000000000017075086c91d61dc6e7eff70a214b1e3cdf067bcaeda45ef5d00e557984a2a7819f9ff19020077362394b1fe374632274ce77174cdbdebc9da0fc54df284dcb42b3a8cb2aab227da413dcd46927c272dd323b669cea7a001ac6247a423378eb94dea3154532dbcab891ef0fcf4f48dee4a689366f3622fa6e60a960c71b074f9520dad549224020100000000004515f0f10ac62807e87230aeb8bc486caac213a6418042c1ed9c1b5a1814c7e190f6e88902002364e9fb81c7b967e39eeb2e4ae6b4391fa262a5603c185cbc906acaf50e5ff7a7df7f3f3dede3b09c2a8b1a7dfd012a3d0c08ab21b5cf15fb4d1f1df9d4ff040b39eaa9ffccfa9ab3b03d5b33f312c13ff8908ddd9c640ede1e4d270aaab51b0100", + "witness_type": 2 + }, + "reward_chain_sp_proof": null, + "transactions_generator": null, + "transactions_generator_ref_list": [], + "transactions_info": null + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_blockchain_state` + +Functionality: Retrieves a summary of the current state of the blockchain and full node + +Usage: chia rpc full_node [OPTIONS] get_blockchain_state [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_blockchain_state +``` +```` + +Response: + +````mdx-code-block +```json +{ + "blockchain_state": { + "block_max_cost": 11000000000, + "difficulty": 1976, + "genesis_challenge_initialized": true, + "mempool_cost": 537334390, + "mempool_fees": 4000, + "mempool_max_total_cost": 550000000000, + "mempool_min_fees": { + "cost_5000000": 0 + }, + "mempool_size": 2, + "node_id": "b3d9de85d29931c10050b56c7afb91c99141943fc81ff2d1a8425e52be0d08ab", + "peak": { + "challenge_block_info_hash": "0xebbe31959ad87c2f802fddb7f29974c56ef461acc5b453ebed9407f8ddf63689", + "challenge_vdf_output": { + "data": "0x0200fb36f5096da1f2cdbebf570d9da9ce95d2c2767f4423bffdb381756064a92046eaf4b1b25700b48f66283960dac64de6b8406fee99f25f05a0a595236b262a035174b9305c1bae316abdfb72032462539459b3475b968e68fd34df1d52a7de050100" + }, + "deficit": 0, + "farmer_puzzle_hash": "0x68e41771a54d741d07cfcc7a9d289a5a5144ad8e6d7cd595f72a2a0f40e63fed", + "fees": 10500010, + "finished_challenge_slot_hashes": null, + "finished_infused_challenge_slot_hashes": null, + "finished_reward_slot_hashes": null, + "header_hash": "0x65b9e51000d4ab6996b98bf27c1ccd4b0861a5e3b2e8acdb14f45d1680e5e484", + "height": 3326213, + "infused_challenge_vdf_output": { + "data": "0x0000891136068e7c213a6010cc8d521c1e1550a05448391b85e8b63d1cd3575407eec88b8371ed61420810a28829d871dd362ddec08bbf107f6f17a8dad18158120058e2d344496815183acbfae20f89cea55876462079acb1181d5a523f4c9357001c03" + }, + "overflow": false, + "pool_puzzle_hash": "0xb197cb377bc5bfed57f84a3d1863e7d305dd57e469e6c4416c8a5ea80cf3069e", + "prev_hash": "0x96170585731ff12a2ec6ea553b763b298671a19c27e20a781fc63c684174e379", + "prev_transaction_block_hash": "0x1630b20b9dc557af2cd75b2e0fb948fedfaa8228f1169d6296fceb61d2a7162b", + "prev_transaction_block_height": 3326210, + "required_iters": 380975, + "reward_claims_incorporated": [ + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032c102", + "puzzle_hash": "0x39b2d9b93c6410297131808c51df1787987d1bcf11feb6ce892fd25db89ecaea" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb0000000000000000000000000032c102", + "puzzle_hash": "0x39b2d9b93c6410297131808c51df1787987d1bcf11feb6ce892fd25db89ecaea" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032c101", + "puzzle_hash": "0xfdf423d6888068fc8dedb5e405e9204def74468040811d67035ab118c7af2ba4" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb0000000000000000000000000032c101", + "puzzle_hash": "0xfdf423d6888068fc8dedb5e405e9204def74468040811d67035ab118c7af2ba4" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032c100", + "puzzle_hash": "0xbbef6c5bf9f0ea5d8c27219a9a3680809f37d90b053f16e349e8092a9f502ffc" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb0000000000000000000000000032c100", + "puzzle_hash": "0x291237b34c6c8416699c8544eb9e2a7f481738418dadb9134c85a05f282829b2" + } + ], + "reward_infusion_new_challenge": "0xd52af21dc0d1aa4dc824ace6de091419677c4940161695ddad2f06f61b8b61d8", + "signage_point_index": 43, + "sub_epoch_summary_included": null, + "sub_slot_iters": 147849216, + "timestamp": 1677831914, + "total_iters": 13740836343855, + "weight": 6803132960 + }, + "space": 25193321725003644928, + "sub_slot_iters": 147849216, + "sync": { + "sync_mode": false, + "sync_progress_height": 0, + "sync_tip_height": 0, + "synced": true + } + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_blocks` + +Functionality: Gets a list of full blocks by height + +:::info important + +There might be multiple blocks at each height. To find out which +one is in the blockchain, use [get_block_record_by_height](#get_block_record_by_height). + +::: + +Usage: chia rpc full_node [OPTIONS] get_blocks [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------------------------------------ | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------- | +| start | INTEGER | True | The start height | +| end | INTEGER | True | The end height (non-inclusive) | +| exclude_header_hash | BOOLEAN | False | Whether to exclude the header hash in the response [Default: false] | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_blocks '{"start": 100, "end": 102, "exclude_header_hash": true}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "blocks": [ + { + "challenge_chain_ip_proof": { + "normalized_to_identity": true, + "witness": "0x0100a57629d394d187d98436d8d3cf5e3d04b15b73fbd46dd4199047cbc0c40ef4a6dbff1a2f0ab68b7333f2884df4821edd4b0f540e5b6c82e466704d81b55dfb3fc7eca3e3ae6c53a6a86414e007a9703218261eab89f72e7f387c84690673a5460100", + "witness_type": 0 + }, + "challenge_chain_sp_proof": { + "normalized_to_identity": true, + "witness": "0x0100832a7be870a7f409e2ce83d161810be7e619f7f7f3d861bc6c661333fe50d4e62652dd22c378732e7c70f3f5ed82716586d3bc082a04e0c239837fa2f33c5e0299a11238785b94ddcf2fe96b0e4b6bf65ab418bcb1b4feb309611e2d8d8966080100", + "witness_type": 0 + }, + "finished_sub_slots": [], + "foliage": { + "foliage_block_data": { + "extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9", + "farmer_reward_puzzle_hash": "0xffb41ab9f269d42924f733cab98e12adf9bbef2961bb744237c33e70138f4fab", + "pool_signature": "0xadecab86c44e96cc96ce52af9ca79ef20a0ff9a4a4ec9b8c21948cf8651186a072f5017c2fa527ef7aac827a47f758d0095403e4a2f9e138b6248dc9d5dca7083f23a218367091f29bfa4ac280aae4abc83d544a662ad8cc4c51fa2845279d01", + "pool_target": { + "max_height": 0, + "puzzle_hash": "0xffb41ab9f269d42924f733cab98e12adf9bbef2961bb744237c33e70138f4fab" + }, + "unfinished_reward_block_hash": "0xe1faa1f4f7e664f943c86d7355b44d45f09a909bc8050af2e7e148a034909dd1" + }, + "foliage_block_data_signature": "0xb9136cbcfcf49e2226af8869e3d5d88934006ef88fbe33b347661facb60f27ffc2520f0a5c1026e4ed25bc67a0f2d48203fb4c0e432ee90bcbf8b0ed8cac4a3060715ff92fbd7278303c4ff69060f1e85d586e7cdab7c14cffb0ce486af9f7b9", + "foliage_transaction_block_hash": null, + "foliage_transaction_block_signature": null, + "prev_block_hash": "0x496efb34579737f871b16ca71e6933be36711271765eaf6aa914f5e1e70cb00c", + "reward_block_hash": "0x49d0931675d6ede5633cee302d6d116637592ca394edabfe7b5e856166e8c074" + }, + "foliage_transaction_block": null, + "infused_challenge_chain_ip_proof": { + "normalized_to_identity": false, + "witness": "0x000014c701a11a22a61f2699a9fbf2a41c122fc2e45c22f05e5134d52ba3816a62d00e0ebef28eadddacf123f36b49b0eb09b2003625295cdc4b5fee5a13b79d792f137c6d0fe18f30af0ca97f620a38b1bdb97978724346a8a0835829c880eb7e2901000000000000031ed49023d56b73dfad1ede5d1136963ad702dd6167b5e7d9e4a9696807268f8bb68a2100003abafdcd1a7f21a90b9c0db5476dd7dfd3331bc9706ff6b421bfe0b07aa7e998821492331e36c6160c56d3a30fce35b35fce0edc6837be841fc99de781f7611f2dfda704ce22402d6bb63668e14c4c97081a53c9c7989f09565d4df0ff645f0c01000000000000095ce0c90c1f4e03752cf1ecb5bc51e4a778f0725d0dccdda1b0ce2b50fb6aea7836d0e503000a8f135979673a0bedd830c2617860f28e3b3b0c2184c7ea87bf9e5a343cfa4ce4ec92bf1899f24bffc6b6f36c3a061a07cc1663848bc75bf37cc869d37b8e2ac1a184e4868e3fde06779f9b76e6f2b581552927024d6a6258cf47f6dc6665380100", + "witness_type": 2 + }, + "reward_chain_block": { + "challenge_chain_ip_vdf": { + "challenge": "0xa5762d4e8bfdb0a0b14fb5b64f498a47585716dc6f302c4856d69d629421db6d", + "number_of_iterations": 37508080, + "output": { + "data": "0x0300d1533b121a4ce116fb7a1aa24242d063ce1f0cc18d2828b512a1c26dd653218233cf7d303b71f199ab35318a725e92411a785c4c7d2f93aa11652ccfd4b9402b51159d43e52230927b6ff56730c17144c87e6db6cadb62c9e2a13fa25b89e8090200" + } + }, + "challenge_chain_sp_signature": "0xb010a05b90be628e4f6ed371ef845256b660c0065c296f466fbcdf5cecb4e7c31a5ab095d8e0cead0c67a323669528e71106935e934731e0ac9dd4cdfc09034700d758632e9891db14aa08e7d88cd74e9eb8c399c743176819d51353a96ea7b0", + "challenge_chain_sp_vdf": { + "challenge": "0xa5762d4e8bfdb0a0b14fb5b64f498a47585716dc6f302c4856d69d629421db6d", + "number_of_iterations": 29360128, + "output": { + "data": "0x000007c75080573253ceac71d020ee668aa51792fdd61eeef009acfb150c424a4a1484198442c8bb6d0dda2afb1098237ac87833a0523031ed6dd5631f4dbd45a838d15482caf9f400f2568e2812796b8ac31d84d13c2f7ee37fd3512d8f23027c060100" + } + }, + "height": 100, + "infused_challenge_chain_ip_vdf": { + "challenge": "0xce285a81b684e3b30425fbf829c8b3da7e96d5e3983eb84c8c2ddece98b23eb5", + "number_of_iterations": 920450, + "output": { + "data": "0x0000baba4014b63bbd31f52fc3a6ff970b5256388b4f031e3b23009198561fcf7c58086d96f0ae151c22f401405935b2cb0541859f7585edd23e9e095c206cbc5c30776516d0259bb15c902eb310db0167541083e6c62e1501c0260f54b6863d2b0c0100" + } + }, + "is_transaction_block": false, + "pos_ss_cc_challenge_hash": "0xa5762d4e8bfdb0a0b14fb5b64f498a47585716dc6f302c4856d69d629421db6d", + "proof_of_space": { + "challenge": "0xa2877f265f2b5d80e35979e32506d07665ee94459fecff1e34b063e1ab4312ff", + "plot_public_key": "0xac51720ccb9ac85841561a7ea70f52b839d996aedc1a76ba0bbaf3d38a21ffd8dd71700535d30b412facfc3054e779d6", + "pool_contract_puzzle_hash": null, + "pool_public_key": "0xae384e452745cb60f5dfe6eb15d7626d42010912c9e88cd98576094c1aa8878615e11fe5c7a8acb1d97b51d67c5b481e", + "proof": "0xe171815c128e21d4f61266ee8490a4ba52776ef7208ff44463e5b421c9d30f9dbdcc80d070057dd3d96b8690df77a28e64977a838d8a149de6c5494aeb8252fa49754feed33e3ddb6a3be6aa5584c2f859aa5c6bc274bc24e9e46574ee41c8c09c8dbd32eec9fc894badf3980295447b92885384248c85a6ef62766cbde32a699d8464bba6f3545efe95e86da322b2c45c6cab0485e8db2b24748b844d6dbe4ee23285c324b87ec7452d5824991259b50a6ec90f6e4c2b47b3ef7336bda9156b1c9ab952c10f257044efd928899d4ec2c6ffe620ced637811483592f66b03e120fb9c22ed7daec6f45dfaa2c93ba8ceec6d12f51a30ade635871dc148ea58de9", + "size": 32 + }, + "reward_chain_ip_vdf": { + "challenge": "0xf45e64b4fc6491516c6afd4f5b75284a980a31e0cc3d4bd124f63aeec2a49833", + "number_of_iterations": 920450, + "output": { + "data": "0x0100b6c8fa5fa401a15babbdbb449e87ecea049e2aef8c8390dc221b82d679a6e31e3de53e22e1699c3b6bb30f4d2f76600d067c93bb82eb684bc21ef16531c91a0e3b80fc958ce3027699c0aed97429547d017822bd264d7899a8f5fbb22432f70b0100" + } + }, + "reward_chain_sp_signature": "0x87ea89c12b555de8df2dff60f651e451c9a9ca0520b64e2f83324e528ccaef3236c33a6afa81b341b8deb09ed59e30c8129508ffa9847e0438109809af7138f1c46f6e1ee62a910dbcc194c843eb44c8e8f812ddc1cc29f8508717369ef3ab87", + "reward_chain_sp_vdf": { + "challenge": "0x4d03536680aac02491e3a0f6e6d47adfeb27e84cb8553397d8017ec028535ff8", + "number_of_iterations": 11626949, + "output": { + "data": "0x01004e657c0f7937d159a1c8e3cf31bac1334f1977ad9c4c666437c9f75eab72f046f84468d119f231905b52dc33e5f91e4747cf2f8569b150220c9f74c7681afd04b11f7bf39f1a7580979382c466610b933f79c0a9c0f2c943de78083ca2f2f7040b02" + } + }, + "signage_point_index": 14, + "total_iters": 440161264, + "weight": 707 + }, + "reward_chain_ip_proof": { + "normalized_to_identity": false, + "witness": "0x00003c8c588e6ca1dc1a8bb6a7705336749d9e7bece4722f0fb956fcd4d63f321664d5dad2f6a1209f0c7b9444f1bf66544a943f6c34c11ff73fd8bc560003def013f36a9a7db270a869b437cc6a1f6cf61d391a7be1cdc6092120b962e263a3aa3901000000000000031ed4e9f61d9de2efa33310981402c720499f1aaf2791db3bc957b36d80873ddc8a6cbf00009b973f711e920a925bb942bee1e61e2b749e78bf72e8577e39365f4e4aa66cd4827b8119e04dea6adc76daf265e99675aee6d1ddd9c153af72b5f449cf0782104a1050638d906ff486965bef4fc97cff2fcf04f6dfa5a11a59760a141fdea90804010000000000095ce09ca0a0a0af431aa3540cffd1df4dfa7c3c50482591f61030ccb13c6f8ad955c6990200243a6365f719df9a29667a9f690d2b512f08a401029dbf31c1eaf9dd46554efcea72ad6d261d02d7467815ae1c1298f37e32e032c2d801ee8255ec436e5f750a4fcbb1450079688de0892bc2fe54a6382f77504ecc576c8d6b421f584b940f140502", + "witness_type": 2 + }, + "reward_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0200f0f21296dde779120a9c7b266b9112b701f1d3ab62fe09ed63f64e4ff73da7cc51597bc3d237c5b2ca2d4d11133f5331d47a92a0a5a32ea36c5a50b721552564b7bf7dc3d34723a830ee7a46c436b407fe6f3c108ffeb96aa8bd95a1b25d521901000000000000276cf8f3b9eb17afa29bce73b02f59cce66afa0e0d7176873415c780946519c1eeec75d1010012f428109fdc8213629fd2be850573a0e962b2edc15219a07cb29dd6fd02e1a76da0bb543db58217429f08e1626edbc225c8934338f6594e2ed6532c88349870a32d07cfc764ee010e23456bc425954a2c9b81aeae482f5b737b98478b9da02101000000000000764620b40c8cb9d6b6e39e8b161185b82b680a4d7c7036088dea1a24b19183eee6bfd897030066c806cbd271380f0b820be100e1c5ec601b88d8b049eeafaa2cf08018aef096da462e76e1cef3a334603afaf1b3db6e23a4473009a5407798b84e867feecc18bb1aa97abf375a1a5099dce7940c3287b67747a107d3da918b0dc14b3e5ac6080100", + "witness_type": 2 + }, + "transactions_generator": null, + "transactions_generator_ref_list": [], + "transactions_info": null + }, + { + "challenge_chain_ip_proof": { + "normalized_to_identity": true, + "witness": "0x030025f9836e1766fbde2ce6a61b60651a4611207eab4c76661fb0314185a82538d74aee9bd4185e664a9e5890491fbc34c758ad8ea0f01098fc83ff03d4e69e6f07484b83f6ef849368612441bc0f8764caf2e92995b18934a9df4dcb2eb6dd62010201", + "witness_type": 0 + }, + "challenge_chain_sp_proof": { + "normalized_to_identity": true, + "witness": "0x000062c5635ff324127600072e3f0b117a207b18e1885701bbcef20c207b327c478efb1e1605547e5920b0e87ade4ac79c28975303747d6b54802c12036b4531ae4a33cd1e12b8d61122a2dc8a86f3e6e9924562728d65ddbeb7e48583dd850cb7380100", + "witness_type": 0 + }, + "finished_sub_slots": [], + "foliage": { + "foliage_block_data": { + "extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9", + "farmer_reward_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7", + "pool_signature": "0xb08c85cf0af39b157fbd531f89c3575b48a87cde9f4c13613c57189c490ad1543e98ef1ffea725c54c7adf45591b823116b7730826fca3ba2314165552cfc88f4e2c41c4aecb6129f144d694126dc79305bc939a3017e793098b6b0e22945c47", + "pool_target": { + "max_height": 0, + "puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7" + }, + "unfinished_reward_block_hash": "0x39f36bac604c0b6676a7ec77314d72cfb64c3460e55791fec1318bb9f99af68d" + }, + "foliage_block_data_signature": "0xa1fb2838601909a1520b8dbbd5543fcee58849051cc1b8bf37f2802baa7ac080b46e4e44f1064b00262f6aa7fdc9022e05ef5b05c8c25c0c4ca55cf1051e9ea89335ae14d021343ce3f91bd95b60dba926b7413d38b903515d0d40a572b0eebf", + "foliage_transaction_block_hash": "0xf870f5319951c970fc65eeff6f16185b94b4bb754ee98fc86f98d6ad45018d13", + "foliage_transaction_block_signature": "0xb967499592d60c4342e98b9f412804c525d42dfe1cff93597bb5afbf0f0d98d121a46be7dacd0075e91cc7819fc0723f0732d30618e20d2c4a27248a6e79a5f582b6fad6308b1ff933a38be01919b2d062a327829e0bfbb24539a90ce5f163ab", + "prev_block_hash": "0x9a6c8728021574c5f3242370831b9fde7a0421f4448b4848276fe1652580c6a7", + "reward_block_hash": "0x100b6fbe0778ae13e48e9bf71b7de4e31e5c1d73a0b041e0277f4a76b5338604" + }, + "foliage_transaction_block": { + "additions_root": "0x37dc0ead981039cdfe0ae3d5c6f379bdd3b81d9d428079b2fcbce32daf69b1b3", + "filter_hash": "0xf8945105b042df1af249e51f2e4fb0bdc115fb0bf3e1906f892d8daf04505b4f", + "prev_transaction_block_hash": "0x6c94307cb88f37ca002936769246579824ecadc77fe1e445d31165e6958288e8", + "removals_root": "0x0000000000000000000000000000000000000000000000000000000000000000", + "timestamp": 1616164827, + "transactions_info_hash": "0xe0a46738000ab8b302d9a98ea602adabe4c2b44c9d775577f1a3f74e4c4d5cf2" + }, + "infused_challenge_chain_ip_proof": { + "normalized_to_identity": false, + "witness": "0x020029fa78b7cd9ce0f6453ed1ab95a3c120787bc3deee67d0d6b94d496646189b3e567888886440b89ac66185b3e4fd08bc9706cd5337f5160f6bd486fcbdd8273cf72b9d6bcee7bd9dc39f668ae0c80727faf7c4eee06158297fff4c552bfe57210100000000000020cda8be65bd71d461e67d6bbb042256f5e49ab66a06702d695e295bef68ec3d8c122f4503004080955d55e40c2d6936d1ec63cd20c5d5cc1ad6151ff9ba136937580a631a9890243a9aeb4c17d352c27351af113e42b49beb056d8b08e843e5e2d1b77e510927b838a67ec6504228b90bcf62b26ad7336eb73337a9b61bd34caa77393a8304030200000000006269c0ae3782dbf513bba4c73244f25305c5734266ec6202b823d1b27957c4f925d4cc1f0100b742b8090ba58abed0f7c8de4f4aa0c9dd77ebf3b651ee11c0fd7699e689cfc03d045ec4cd04d5defc1fac8858d7f310192daa6ca93682fa15e590369ad63427de53adf0ed76b6cc2c1fe2892baa7195d6a0ac16b2e21754db560729962cf4520100", + "witness_type": 2 + }, + "reward_chain_block": { + "challenge_chain_ip_vdf": { + "challenge": "0xa5762d4e8bfdb0a0b14fb5b64f498a47585716dc6f302c4856d69d629421db6d", + "number_of_iterations": 47182489, + "output": { + "data": "0x0000af33fa9862d4e257498e9ba0c3cda09c1389d1fde0facd72ea26f5371ba94deb18137d95bd83b1c7afefba6293feda91d744d014c747e132db0247839e9bd00d790c06f753a9d344c80c455a86ecd979c31687ece60748a5d62dca4723c3780d0906" + } + }, + "challenge_chain_sp_signature": "0x94780490364f4ab2a7e9186377729444fbcdba4c8d25f8a2d9f91a42ed8ca798790f7d9876190a9a68eff1ed52d9c3da15dd678e9aa463fbcc8cb9cff9f37cdf0e53381b88735d8ac0a498925319c655a261747ccabe3b20e36d4669a8bb0a4e", + "challenge_chain_sp_vdf": { + "challenge": "0xa5762d4e8bfdb0a0b14fb5b64f498a47585716dc6f302c4856d69d629421db6d", + "number_of_iterations": 39845888, + "output": { + "data": "0x010012fb95381abeff50aa787f5d5071cde8046f0301c84121d91c4bde0a6d491844d8386e536f30f4818468d0fb4319a9fe1abb4548cdab4f62405915acb5c37132cb302909847b0b869d07074e546b6501efcd1cab4193c9ebbc4f79f3abfd48580100" + } + }, + "height": 101, + "infused_challenge_chain_ip_vdf": { + "challenge": "0xce285a81b684e3b30425fbf829c8b3da7e96d5e3983eb84c8c2ddece98b23eb5", + "number_of_iterations": 9674409, + "output": { + "data": "0x0300a4bc6790208e73245df6a85b3f7beac0d17e73972b414a7f94cf1e3c3e9bb4a400516d368cfa8b1814f3b5163fe5a54a1fe35781f58290673c8d9f56cd23b94c138b21207d6aa6f3049f8ad805eb99b28292e06e748117e78e13598cee9945670100" + } + }, + "is_transaction_block": true, + "pos_ss_cc_challenge_hash": "0xa5762d4e8bfdb0a0b14fb5b64f498a47585716dc6f302c4856d69d629421db6d", + "proof_of_space": { + "challenge": "0x4afbc47ce97b7879f32f264279a901a250dd04b537d2a31a284855f31fae497d", + "plot_public_key": "0xa1643e8e1232e278ed8288b1d799e96d77a965ce6790c0c0b48bd221fbd75b6a3c0cdb4c41094f4635f92c6f16d4bc1e", + "pool_contract_puzzle_hash": null, + "pool_public_key": "0xa5d46513ca3dfbb0fc0e22a23f2829760049ee5b1be7c07e8189572a98d1499bb0332d09f2b7a0dfa64d89e2c0b2eb02", + "proof": "0x4aec6c0681a5dc053aa77a1361060fb77d83c2c51e356867be8e16edc7adfe5744ff2d41ae9c8baec6033459bfd2131be11bef5d0dafbe26ddf06ba1fc641ef7e84869de2039445e51a20d2f8e24470b0ee5e3907186e0a2eb2389bb0250316e3919e5a65a8c75c707915538b1d08a2225c6facaa44aca58aa6e7daf97290e931f4556f569b5b1f4f86f5cd94116cd35373c0f2dc3b8d288670cd949b77f15782c3ac6f94b7b5406ad8901c15bf0f5cc07c0993055db4fed379d4ba05a4d08a6bcf491b73d01283d7ac90f81c5468f0bbe4e3de84d27ab9bfa271710ce51800ff579eb6aa8ee98f03d999f24feb0035c4b621d6ff7e0ba8d337be8c4c019b640", + "size": 32 + }, + "reward_chain_ip_vdf": { + "challenge": "0x49d0931675d6ede5633cee302d6d116637592ca394edabfe7b5e856166e8c074", + "number_of_iterations": 9674409, + "output": { + "data": "0x01008f895f468f126a02004589c77c659bb55d9931ef120303bdfbb772432aeba315e4f06185389d8bcfbb2282fdbb2a1d2221512d3b8207ce048ac2fe7b036d4e0f7258f15caccfa7547bf1634f955510b1c3a46efb58a2ec599a3b4876e9e15b0d0100" + } + }, + "reward_chain_sp_signature": "0xb80944bd1025f63f5931c7ff7c99cec55c82c62cbccaa17340be94a7ca6fe7681e420ae00377452666c09aa41296e64004ed4c16c9edfb43593b3490d9a5da9c3822204b9e94aee61cc215c69774bf663dc48eed05e43443a0bbca91bf72114e", + "reward_chain_sp_vdf": { + "challenge": "0x49d0931675d6ede5633cee302d6d116637592ca394edabfe7b5e856166e8c074", + "number_of_iterations": 2337808, + "output": { + "data": "0x0100ffe63ea44b1340961a25c398c66ab1c56479ea16a746eee8ca2aab8bbf682b0d777993cb840488ff86e16eb6acfc2b8068acd72f761af76647849f1b4a835a3516e2ccf739b579bd999bfc2d46a4b55ef445c043fe0c714b2428ddd1351d82100100" + } + }, + "signage_point_index": 19, + "total_iters": 449835673, + "weight": 714 + }, + "reward_chain_ip_proof": { + "normalized_to_identity": false, + "witness": "0x0300059c76107499c7b8c60fcbc02b4f17ed2a144614a882e42f9a23d8f506dce485200551cb47925a09f68a51fdfb033cf6e7f63bbac376670dc746dab3376c420e93707b7cf8164b3dcb2a091606f83de6a51c2358c1094ad5c4ac4ea06355f20c0402000000000020cda8da7c9b0c374261fd87f7cf7f2c72ec38cd79f11c27e7311db84a54d040bbd7905700006ffe8cc021de8752ed9c2ece79619bfe564b51a4944c0eb6a332a2a1f74a71be2a6846e721618f20196de4644c81564df706213018dfae7a8c6481a71012530addeeff07ede9cfd3e0593ef6b2c2b88539f5fc9fd9ace1db646971e29a439115010000000000006269c09732bf539d6e6caab8a0acc797bba6f13f8082cf7ee12ee82324456342470666f30000e7e3a77ff1d4d57ba4c37994c0932099f5fa10e59b37f6c2ee6084c63d4445b176f8826c6af947bb1d2a60fc1ef7543c054076a53459dae9b6dd9382b24b930c55e307925b32bf333db54cc8c85cc61e1c6d99369ea6a17fce4d5616ccf3e2170201", + "witness_type": 2 + }, + "reward_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0300fa5f9ce4e42677915f7dbe5914a58c9ff496bcabbecc5deb5e7931905b525dcc440964902d65482817f99cb85c506eec42421d7466d4253203afb3305c2c130e471bcf0546f16e6d02f3e91c86af0a0c163c28abdb6a7df72df9e87ec13933010100000000000007ed4c9e57adab5b004af49ff191803461f8cb67e45a77bf1debe679f01c61c690523c930000e2cb7363ee532c2045f873373e44d43d8262bd1f77294caf65e1a2fecf26c08200cbb62611e981c29aea737b128cd57b8f876ee745a0541bb4912490409960090792e5ca693fbd3eedcb5a6d98c6d1339b170bb08a9159bce19add182747010c0100000000000017c7e4ba19541c7da9e09dbf518b3c4024fa66eff40ef256d00aeb6a90857b22c8889b3d030069971c64cc178c9620125972c6a7ca21598d64e482e85a9bb399c9b0bcdd9390c10070c9cfaa90ec4465782a887077f0239840bc2106747624bd27ad27bc2f56989ccbc5bda15a43ad34ed723d06abb67c5735820ad3658d155a49ef149c2d020100", + "witness_type": 2 + }, + "transactions_generator": null, + "transactions_generator_ref_list": [], + "transactions_info": { + "aggregated_signature": "0xc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "cost": 0, + "fees": 0, + "generator_refs_root": "0x0101010101010101010101010101010101010101010101010101010101010101", + "generator_root": "0x0000000000000000000000000000000000000000000000000000000000000000", + "reward_claims_incorporated": [ + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061", + "puzzle_hash": "0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000000061", + "puzzle_hash": "0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588" + } + ] + } + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_block_count_metrics` + +Functionality: Gets various metrics for the blockchain's blocks + +Currently shows: + +- compact blocks +- hint count +- uncompact blocks + +Usage: chia rpc full_node [OPTIONS] get_block_count_metrics [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_block_count_metrics +``` +```` + +Response: + +````mdx-code-block +```json +{ + "metrics": { + "compact_blocks": 2190434, + "hint_count": 5895366, + "uncompact_blocks": 1135855 + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_block_record` + +Functionality: Retrieves a block record by header hash + +Usage: chia rpc full_node [OPTIONS] get_block_record [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------- | :--------- | :------- | :------------------------ | +| header_hash | HEX STRING | True | The block's `header_hash` | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_block_record '{"header_hash": "0x3723909a7374c4c88cf00ab9b15365f4988f5bdb2d51bac23f6af939fe40f56c"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "block_record": { + "challenge_block_info_hash": "0x08dbc5c9f4676bad4cd2fad9b120afefdc107ffdd4066f73f14baf2a204f13df", + "challenge_vdf_output": { + "data": "0x0000af33fa9862d4e257498e9ba0c3cda09c1389d1fde0facd72ea26f5371ba94deb18137d95bd83b1c7afefba6293feda91d744d014c747e132db0247839e9bd00d790c06f753a9d344c80c455a86ecd979c31687ece60748a5d62dca4723c3780d0906" + }, + "deficit": 9, + "farmer_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7", + "fees": 0, + "finished_challenge_slot_hashes": null, + "finished_infused_challenge_slot_hashes": null, + "finished_reward_slot_hashes": null, + "header_hash": "0x3723909a7374c4c88cf00ab9b15365f4988f5bdb2d51bac23f6af939fe40f56c", + "height": 101, + "infused_challenge_vdf_output": { + "data": "0x0300a4bc6790208e73245df6a85b3f7beac0d17e73972b414a7f94cf1e3c3e9bb4a400516d368cfa8b1814f3b5163fe5a54a1fe35781f58290673c8d9f56cd23b94c138b21207d6aa6f3049f8ad805eb99b28292e06e748117e78e13598cee9945670100" + }, + "overflow": false, + "pool_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7", + "prev_hash": "0x9a6c8728021574c5f3242370831b9fde7a0421f4448b4848276fe1652580c6a7", + "prev_transaction_block_hash": "0x6c94307cb88f37ca002936769246579824ecadc77fe1e445d31165e6958288e8", + "prev_transaction_block_height": 97, + "required_iters": 1045145, + "reward_claims_incorporated": [ + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061", + "puzzle_hash": "0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000000061", + "puzzle_hash": "0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588" + } + ], + "reward_infusion_new_challenge": "0x100b6fbe0778ae13e48e9bf71b7de4e31e5c1d73a0b041e0277f4a76b5338604", + "signage_point_index": 19, + "sub_epoch_summary_included": null, + "sub_slot_iters": 134217728, + "timestamp": 1616164827, + "total_iters": 449835673, + "weight": 714 + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_block_records` + +Functionality: Retrieves block records in a range + +Usage: chia rpc full_node [OPTIONS] get_block_records [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :---- | :------ | :------- | :------------------------------------------------ | +| start | INTEGER | True | The start height (inclusive) | +| end | INTEGER | True | The end height (non-inclusive) | + +
+Example + +Get two block records (`3 300 000` and `3 300 001`): + +````mdx-code-block +```json +chia rpc full_node get_block_records '{"start": 3300000, "end": 3300002}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "block_records": [ + { + "challenge_block_info_hash": "0x79394495dd087fb6b11625882873a28f543646ba810c5353aa633b0daec8b996", + "challenge_vdf_output": { + "data": "0x0000ee8044c2c04336966a6722ab75df2f4a92d6c975b8b21ea0fbee2cd3294517d40a838c4c77dc50ba271c6cfcba05f37adb117f7c58ce3702f25323cb7587ec4fe56eba0e03f3934ee601fdd6a7e7e6339fadb464fbc22dde3dfb1a4f017b822a0100" + }, + "deficit": 9, + "farmer_puzzle_hash": "0xa125a444c8e19ed236590f22c9c79cf6d9af8f734a11a806281371bacffb6125", + "fees": null, + "finished_challenge_slot_hashes": null, + "finished_infused_challenge_slot_hashes": null, + "finished_reward_slot_hashes": null, + "header_hash": "0xc394100ba86cf56e77ba892187c97756bf1c7450726b4f42e4549d2700ef0e37", + "height": 3300000, + "infused_challenge_vdf_output": { + "data": "0x0300749020231e6ddbfab6d06ec0cc2f839cd9292963d482047c636c1af76cc9db8d6cdfd96e323ab273cd017dd9add5af1df85191bf2d2dbfb669ee61ac006fea095532e70a0d8de7f6dc9fd476421ca5d9ff05bf6e68165ab87376908bdbf1231a0200" + }, + "overflow": false, + "pool_puzzle_hash": "0xa745c56e6c8dce62ac2719ed1fe877e667e758cd6e03c43d4ebbacb3ec3eb0ed", + "prev_hash": "0x844197000822115a256155392367c0855a9a8bf5543e54dd7b110e58e843a1f0", + "prev_transaction_block_hash": null, + "prev_transaction_block_height": 3299994, + "required_iters": 1908970, + "reward_claims_incorporated": null, + "reward_infusion_new_challenge": "0xabe4681408184e29c887fb406add6a8284720018f3cbbd06172f896089d71e95", + "signage_point_index": 4, + "sub_epoch_summary_included": null, + "sub_slot_iters": 147849216, + "timestamp": null, + "total_iters": 13620403757290, + "weight": 6751171816 + }, + { + "challenge_block_info_hash": "0xf577c44e258c6f5583a1e1d1f7171709ab2a8b007dfa0df7f2214d14b30ffb7b", + "challenge_vdf_output": { + "data": "0x0000a9627dc0fa2d84ba6cd417d454b0661778bf1ef0dc5eb4135ff5e58d0d077c8e3454357218f414b00d1516b722109b62ce628e0580612f9c70c4ac61059fa006dfaa1219f83a8e2b60a5f1131ac1d6a710e02241ac5414c968e989226250f6030600" + }, + "deficit": 8, + "farmer_puzzle_hash": "0x64e5e7b956b199674e6230c9424f228c2c8fda6a229386ca6dd90bc53648e624", + "fees": 50000000, + "finished_challenge_slot_hashes": null, + "finished_infused_challenge_slot_hashes": null, + "finished_reward_slot_hashes": null, + "header_hash": "0x1d9dcddfd409f9c6be5623e13ef3fe5584a936e619f0690eb6e4e8e1a96acfc2", + "height": 3300001, + "infused_challenge_vdf_output": { + "data": "0x0100d79a1b79d6a98ce66fcd479afed0f80b584a1e292a7811c656d00de10f704d402392a9fbb325f405c3da65828fea96136bbd7b9f3268a197c42be3c4449e7c54cd5ed1828620756aa9d17f87971681c7adb08f1b86335af3824959e41fb7b42e0100" + }, + "overflow": false, + "pool_puzzle_hash": "0xe1579c7eec5a7fec8fc901c9aafef25653955a88bead3228193197e14a373231", + "prev_hash": "0xc394100ba86cf56e77ba892187c97756bf1c7450726b4f42e4549d2700ef0e37", + "prev_transaction_block_hash": "0x96cb9b84cfecd579b3e1eb5ae5c9e35b419b080487e09f11ace406185080966f", + "prev_transaction_block_height": 3299994, + "required_iters": 1018573, + "reward_claims_incorporated": [ + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000325a9a", + "puzzle_hash": "0xac7470110664129f6b6a42fd848fb35f08315a1ef61865ad9f0b5504ff1d3ba3" + }, + { + "amount": 250012570003, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000325a9a", + "puzzle_hash": "0xac7470110664129f6b6a42fd848fb35f08315a1ef61865ad9f0b5504ff1d3ba3" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000325a99", + "puzzle_hash": "0x907491ca39c35bc1f9a6eda33f7c0f97a9f583975088dad7216f1edd79f522ae" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000325a99", + "puzzle_hash": "0x907491ca39c35bc1f9a6eda33f7c0f97a9f583975088dad7216f1edd79f522ae" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000325a98", + "puzzle_hash": "0xa801e07ca857c207756ebdae6b2d5b9964766588c170929d2587ba14d5771791" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000325a98", + "puzzle_hash": "0x9a8990caadda4fe57876ab878134b3fed786ca66ad32e71b34a1ac5ad3aea00a" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000325a97", + "puzzle_hash": "0x7faa98823590b2bb8fa8dd654c0e4ce6e9262a3453e50d243ec6c25958a557d9" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000325a97", + "puzzle_hash": "0xbf74889b9c3a161b4d30e0494fbfe8bdfc410d7ace65af15946795bf84d196b4" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000325a96", + "puzzle_hash": "0x4bc6435b409bcbabe53870dae0f03755f6aabb4594c5915ec983acf12a5d1fba" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000325a96", + "puzzle_hash": "0x4bc6435b409bcbabe53870dae0f03755f6aabb4594c5915ec983acf12a5d1fba" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000325a95", + "puzzle_hash": "0x4bc6435b409bcbabe53870dae0f03755f6aabb4594c5915ec983acf12a5d1fba" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000325a95", + "puzzle_hash": "0x4bc6435b409bcbabe53870dae0f03755f6aabb4594c5915ec983acf12a5d1fba" + } + ], + "reward_infusion_new_challenge": "0xa822a8aa0a6ff3ac799e9ee82c3d03c3c39706ccafbe8a02e30436231078ce74", + "signage_point_index": 7, + "sub_epoch_summary_included": null, + "sub_slot_iters": 147849216, + "timestamp": 1677343391, + "total_iters": 13620409797325, + "weight": 6751173768 + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_block_record_by_height` + +Functionality: Retrieves a block record by height + +Usage: chia rpc full_node [OPTIONS] get_block_record_by_height [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :----- | :------ | :------- | :-------------------------------------------------------------- | +| height | INTEGER | True | The height to get (must be \<= peak height) | + +:::note + +Note that not all blocks will have all fields set here (depending on transaction block, finishing sub epoch, etc). + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_block_record_by_height '{"height": 3000000}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "block_record": { + "challenge_block_info_hash": "0x8b51a91841d9b962b11a3aad0e186f9258bda32c8a4bb8a8c2a10220652e7310", + "challenge_vdf_output": { + "data": "0x0300c819de4b04e4ae20a4c886395045108a5a39db80edbb951f0376dd1eba388748584b5af92625806d2412bbd2e2eb5ceeb5b122e584b9ca8b6067286514c90b07a9e9f64b4ba0bf96478a178651de6cc715eb179f3743de49e4ae7046d188620e0100" + }, + "deficit": 6, + "farmer_puzzle_hash": "0x93263bcd4d1c10bb099490eff5ebe0d1f83c96899b93e807424cf7aa17fe1503", + "fees": 0, + "finished_challenge_slot_hashes": null, + "finished_infused_challenge_slot_hashes": null, + "finished_reward_slot_hashes": null, + "header_hash": "0x1743f356fc9a811fc8bf6bc9fbf3d2ed973f3c4cef132356d5cce390731e4c63", + "height": 3000000, + "infused_challenge_vdf_output": { + "data": "0x01000d9d6e70b698db981a616929ba57b2110e081c34a87a409ef15832f334dfefe97286433c733781959c17ebb34bee5c3e14199c4a43a88c0a90f8feae2ba7341e0957e34a655959b001c8d31a80e18f42af303a1932dd58e72b7dc9e31b0886220200" + }, + "overflow": false, + "pool_puzzle_hash": "0xf72bcbd49b412e84f46d4637220252bd0e3a4564c53ae07f9acf2ae84229ba3e", + "prev_hash": "0x7022a20bb06dc47248731823e1ad01a8105ef3e01f3a3f20d9cf25ff0df765b0", + "prev_transaction_block_hash": "0x07a631da0cae81a34c4cf33e40ac394466141ad3aadc1e498c8f641f2713c5c4", + "prev_transaction_block_height": 2999995, + "required_iters": 2245369, + "reward_claims_incorporated": [ + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a000000000000000000000000002dc6bb", + "puzzle_hash": "0x7a0790d18588bc84007e7d4a3e53e293fa1c0ca350d2b6a42659b3ae38c4561f" + }, + { + "amount": 250050001011, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb000000000000000000000000002dc6bb", + "puzzle_hash": "0xe3b9adc4eb09d18d83bd56482aee566820f5afdce595b3ed095eb36c5cef9301" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a000000000000000000000000002dc6ba", + "puzzle_hash": "0x9470b0ba0a8697dc2b702aae1d259e0bdbdf18c7d1be3709e93ae583f078ffd5" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb000000000000000000000000002dc6ba", + "puzzle_hash": "0x309c0113f358c627e1a9c42069eab159b209ea7f15d2a615a1f65fa368e160bc" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a000000000000000000000000002dc6b9", + "puzzle_hash": "0xebc07ca111c48d4ccc5c716108e1765cb960055a31312d2604fbe77685b880a1" + }, + { + "amount": 250000000000, + "parent_coin_info": "0x3ff07eb358e8255a65c30a2dce0e5fbb000000000000000000000000002dc6b9", + "puzzle_hash": "0x185af79d5e58571645103a6e39d5e9399410059c8c279a601054326240cff77e" + } + ], + "reward_infusion_new_challenge": "0xe4c1bf71e8761ca66e3612b6ad3f2f7f08ae325112ede3b7826a56ddeafb7282", + "signage_point_index": 14, + "sub_epoch_summary_included": null, + "sub_slot_iters": 147849216, + "timestamp": 1671732821, + "total_iters": 12236354061049, + "weight": 6173224536 + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_block_spends` + +Functionality: Retrieves every coin that was spent in a block. Requires the header hash of the block to retrieve + +Usage: chia rpc full_node [OPTIONS] get_block_spends [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------- | :--------- | :------- | :------------------------ | +| header_hash | HEX STRING | True | The block's `header_hash` | + +:::note + +Keep in mind that most blocks do not contain any transactions. These blocks will simply return "[]" for this request. + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_block_spends '{"header_hash": "0x65b9e51000d4ab6996b98bf27c1ccd4b0861a5e3b2e8acdb14f45d1680e5e484"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "block_spends": [ + { + "coin": { + "amount": 1, + "parent_coin_info": "0x3a25aa4b8aea2fbc1d2aa6cd3aafe883668035344b8f7f99b19f3ecc8d1a20c8", + "puzzle_hash": "0x811b4bef78021d2687976861559de784ddbcb57401302e345a7b09f87071453a" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fffff010180ffff01ff02ff36ffff04ff02ffff04ff05ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff0bff80808080ffff04ff2fffff04ff0bffff04ff5fff808080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4602ff3304ffff0101ff02ffff02ffff03ff05ffff01ff02ff5cffff04ff02ffff04ff0dffff04ffff0bff2cffff0bff24ff3880ffff0bff2cffff0bff2cffff0bff24ff3480ff0980ffff0bff2cff0bffff0bff24ff8080808080ff8080808080ffff010b80ff0180ff02ffff03ff0bffff01ff02ff32ffff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ffff02ff2affff04ff02ffff04ffff02ffff03ffff09ff23ff2880ffff0181b3ff8080ff0180ff80808080ff80808080808080ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffffff0bffff0bff17ffff02ff3affff04ff02ffff04ff09ffff04ff2fffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ff5f80ff0bff81bf80ff02ffff03ffff20ffff22ff4fff178080ffff01ff02ff7effff04ff02ffff04ff6fffff04ffff04ffff02ffff03ff4fffff01ff04ff23ffff04ffff02ff3affff04ff02ffff04ff09ffff04ff53ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff81b3ff80808080ffff011380ff0180ffff02ff7cffff04ff02ffff04ff05ffff04ff1bffff04ffff21ff4fff1780ff80808080808080ff8080808080ffff01ff088080ff0180ffff04ffff09ffff18ff05ffff010180ffff010180ffff09ff05ffff01818f8080ff0bff2cffff0bff24ff3080ffff0bff2cffff0bff2cffff0bff24ff3480ff0580ffff0bff2cffff02ff5cffff04ff02ffff04ff07ffff04ffff0bff24ff2480ff8080808080ffff0bff24ff8080808080ffffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff26ffff04ff02ffff04ff09ff80808080ffff02ff26ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ff5effff04ff02ffff04ff05ffff04ff0bffff04ffff02ff3affff04ff02ffff04ff09ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfff80808080808080808080ffff04ffff04ff20ffff04ff17ff808080ffff02ff7cffff04ff02ffff04ff05ffff04ffff02ff82017fffff04ffff04ffff04ff17ff2f80ffff04ffff04ff5fff81bf80ffff04ff0bff05808080ff8202ff8080ffff01ff80808080808080ffff02ff2effff04ff02ffff04ff05ffff04ff0bffff04ffff02ffff03ff3bffff01ff02ff22ffff04ff02ffff04ff05ffff04ff17ffff04ff13ffff04ff2bffff04ff5bffff04ff5fff808080808080808080ffff01ff02ffff03ffff09ff15ffff0bff13ff1dff2b8080ffff01ff0bff15ff17ff5f80ffff01ff088080ff018080ff0180ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfffff04ff82017fff8080808080808080808080ff02ffff03ff05ffff011bffff010b80ff0180ff018080ffff04ffff01ffa024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffa01844ac993a536e7b25c5e33f19ca103f31e62ce2cda83fe440c8bae8fe99338fa0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff8202ffffff01ff02ff16ffff04ff02ffff04ff05ffff04ff8204bfffff04ff8206bfffff04ff82017fffff04ffff0bffff19ff2fffff18ffff019100ffffffffffffffffffffffffffffffffff8202ff8080ff0bff82017f80ff8080808080808080ffff01ff04ffff04ff08ffff04ff17ffff04ffff02ff1effff04ff02ffff04ff82017fff80808080ff80808080ffff04ffff04ff1cffff04ff5fffff04ff8206bfff80808080ff80808080ff0180ffff04ffff01ffff32ff3d33ff3effff04ffff04ff1cffff04ff0bffff04ff17ff80808080ffff04ffff04ff1cffff04ff05ffff04ff2fff80808080ffff04ffff04ff0affff04ff5fff808080ffff04ffff04ff14ffff04ffff0bff5fffff012480ff808080ff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a00213db9cb540a52c39071ef70acdf81796303189061b5aa0ee8098a05d5ceff5ffff04ffff01a0ab10c34fd041ae68c744c646d447c84fe4e4e8f469d309540a1496077ce0ce95ffff04ffff01b0a16b798de8c9d15d163e96755e85d7be75cafd62683dbc02640f4c505f8c72b16927e94682d81aa962415a6c69e507d0ffff04ffff01a0ccd5bb71183532bff220ba46c268991a00000000000000000000000000000000ffff04ffff01a0d90b161aa036092a9da80c8cf23c4147c825469eab4bc481c7d8d916a328df88ff01808080808080ff01808080", + "solution": "0xffffa037ad3fd0a81a40c14b182fdf37f27db0dda05261df84fe304f83f507ccc2f515ffa0d05636e1bf40d6077c23fbbecdeac4b7f812af15b08289f57e00bcb0e5770e58ff0180ff01ffff8601977420dc00ff8332c0fc8080" + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032c0fc", + "puzzle_hash": "0xab10c34fd041ae68c744c646d447c84fe4e4e8f469d309540a1496077ce0ce95" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff82017fffff01ff04ffff04ff38ffff04ffff0bffff02ff2effff04ff02ffff04ff05ffff04ff81bfffff04ffff02ff3effff04ff02ffff04ffff04ff05ffff04ff0bff178080ff80808080ff808080808080ff82017f80ff808080ffff04ffff04ff3cffff01ff248080ffff04ffff04ff28ffff04ff82017fff808080ff80808080ffff01ff04ffff04ff24ffff04ff2fff808080ffff04ffff04ff2cffff04ff5fffff04ff81bfff80808080ffff04ffff04ff10ffff04ff81bfff808080ff8080808080ff0180ffff04ffff01ffffff49ff463fffff5002ff333cffff04ff0101ffff02ff02ffff03ff05ffff01ff02ff36ffff04ff02ffff04ff0dffff04ffff0bff26ffff0bff2aff1280ffff0bff26ffff0bff26ffff0bff2aff3a80ff0980ffff0bff26ff0bffff0bff2aff8080808080ff8080808080ffff010b80ff0180ffff0bff26ffff0bff2aff3480ffff0bff26ffff0bff26ffff0bff2aff3a80ff0580ffff0bff26ffff02ff36ffff04ff02ffff04ff07ffff04ffff0bff2aff2a80ff8080808080ffff0bff2aff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffff04ffff01a01844ac993a536e7b25c5e33f19ca103f31e62ce2cda83fe440c8bae8fe99338fffff04ffff01a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff0183093a80ffff04ffff01a064dfc086d72c4e27434c86cc7af122e25abf79e34374f7e6fb4ffb2f71300b7dff01808080808080", + "solution": "0xffa0d05636e1bf40d6077c23fbbecdeac4b7f812af15b08289f57e00bcb0e5770e58ffa0b3d21c178fd29260ae0e765aaebf4b59018e9dcf394af9e32e3ba0b445f312d480" + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xc66f0bee6f69be66022f4b7c14df156402e8b567a518f0cf6a3b60c30002d14e", + "puzzle_hash": "0x0213db9cb540a52c39071ef70acdf81796303189061b5aa0ee8098a05d5ceff5" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b083a7441862bed949ce9fd14d41e46c49357108a573eb71b98d8a504d1b8966404d5e61cec63ecbd35e1ebec05820e434ff018080", + "solution": "0xff80ffff01ffff33ffa057e5ca9b295c025134c9da49070d439973be2184a6226931f110e18ce703062dff8601977388458080ffff34ff84009896808080ff8080" + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0x5a3f2718fb6778fdd80836bebfce25f2ea7dc50d184a106f29c307166126c059", + "puzzle_hash": "0xed6e015250481a9046d489fd8954bc77b8c828c33679c5e3c50e7c4dcf7481ac" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa05a3f2718fb6778fdd80836bebfce25f2ea7dc50d184a106f29c307166126c059a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc06268747470733a2f2f697066732e696f2f697066732f516d6565315050316b6873613963684468505844593457665a3334616a3862365a46453958444772444b676d61343f66696c656e616d653d5865727865735f476f6c64656e5f4b65792e706e6780ffff68a02ff71fc0a98df4f2b4eee5d188c5a1c5fd65edf38f0891116e711efea9e933c4ffff826d75ffc06068747470733a2f2f697066732e696f2f697066732f516d61573273504e7955616775474b6e344876623654316e4a694142433733764677374b715675656661684671793f66696c656e616d653d4b6579735f6f665f5865727865732e6a736f6e80ffff826c75ffc07d68747470733a2f2f697066732e696f2f697066732f516d515855553333326b7762633831717a7234434b597170505541774c36526a52567059355164746732427854503f66696c656e616d653d7468652d6d696e74616e6769626c652d636f6c6c65637469626c652d6e66742d6c6963656e73652d76312e302e70646680ffff82736e820259ffff827374820456ffff826d68a06f33625874a1f75f8e51869e9822d6dd0dc0f8395d4c0d6dc23de2a4a3b99295ffff826c68a0a75f52a7e705273993286b22c6e4f5b7b49f427ea588c36189f32b51d743924f80ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff17ffff04ff0bffff04ffff02ff2fff5f80ff80808080808080ffff04ffff01ffffff82ad4cff0233ffff3e04ff81f601ffffff0102ffff02ffff03ff05ffff01ff02ff2affff04ff02ffff04ff0dffff04ffff0bff32ffff0bff3cff3480ffff0bff32ffff0bff32ffff0bff3cff2280ff0980ffff0bff32ff0bffff0bff3cff8080808080ff8080808080ffff010b80ff0180ff04ffff04ff38ffff04ffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ffff02ff2effff04ff02ffff04ffff02ffff03ff81afffff0181afffff010b80ff0180ff80808080ffff04ffff0bff3cff4f80ffff04ffff0bff3cff0580ff8080808080808080ff378080ff82016f80ffffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff2fffff01ff80ff808080808080808080ff0bff32ffff0bff3cff2880ffff0bff32ffff0bff32ffff0bff3cff2280ff0580ffff0bff32ffff02ff2affff04ff02ffff04ff07ffff04ffff0bff3cff3c80ff8080808080ffff0bff3cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff5fffff01ff02ffff03ffff09ff82011fff3880ffff01ff02ffff03ffff09ffff18ff82059f80ff3c80ffff01ff02ffff03ffff20ff81bf80ffff01ff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff82019fffff04ff82017fff80808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff0180ffff01ff02ffff03ffff09ff82011fff2c80ffff01ff02ffff03ffff20ff82017f80ffff01ff04ffff04ff24ffff04ffff0eff10ffff02ff2effff04ff02ffff04ff82019fff8080808080ff808080ffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ffff02ff0bffff04ff17ffff04ff2fffff04ff82019fff8080808080ff8080808080808080808080ffff01ff088080ff0180ffff01ff02ffff03ffff09ff82011fff2480ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0122ffff0dff82029f8080ffff01ff02ffff03ffff09ffff0cff82029fff80ffff010280ff1080ffff01ff0101ff8080ff0180ff8080ff018080ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff8080808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff018080ff018080ff0180ffff01ff02ff3affff04ff02ffff04ff05ffff04ff0bffff04ff81bfffff04ffff02ffff03ff82017fffff0182017fffff01ff02ff0bffff04ff17ffff04ff2fffff01ff808080808080ff0180ff8080808080808080ff0180ff018080ffff04ffff01a0c5abea79afaa001b5427dfa0c8cf42ca6f38f5841b78f9b3c252733eb2de2726ffff04ffff0180ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff04ff82013fffff04ff80ffff04ffff02ffff03ffff22ff82013fffff20ffff09ff82013fff2f808080ffff01ff04ffff04ff10ffff04ffff0bffff02ff2effff04ff02ffff04ff09ffff04ff8205bfffff04ffff02ff3effff04ff02ffff04ffff04ff09ffff04ff82013fff1d8080ff80808080ff808080808080ff1580ff808080ffff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ffff01ff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ff0180ff80808080ffff01ff04ff2fffff01ff80ff80808080ff0180ffff04ffff01ffffff3f02ff04ff0101ffff822710ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff2cff1480ffff0bff2affff0bff2affff0bff2cff3c80ff0980ffff0bff2aff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ff17ffff01ff04ffff04ff10ffff04ffff0bff81a7ffff02ff3effff04ff02ffff04ffff04ff2fffff04ffff04ff05ffff04ffff05ffff14ffff12ff47ff0b80ff128080ffff04ffff04ff05ff8080ff80808080ff808080ff8080808080ff808080ffff02ff16ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fff8080808080808080ff8080ff0180ffff0bff2affff0bff2cff1880ffff0bff2affff0bff2affff0bff2cff3c80ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa05a3f2718fb6778fdd80836bebfce25f2ea7dc50d184a106f29c307166126c059a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01a09acd380a9dfc2bf20558dffb34eab7e51fb9d98391bf8510d56bde893dbbb591ffff04ffff018202eeff0180808080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0839fd70445d6e34f508b42d85f69bf9da7bed3573f49b6992cb0237b91a3b295e5266dfec8dcd4d6f4727a2dab926e2cff018080ff018080808080ff018080808080ff01808080", + "solution": "0xffffa0ba65e7e5a65dbb7184c4b0b4a2e26393339ee1721f89c39974dabdf280f4b6a0ff0180ff01ffffffff80ffff01ffff81f6ffa0146d96a4267dc05f52f01233f1301633597607bc0b0e57aadfb780bb8bfb6360ff80ffa0299988a298a51ab241932fd15c265746c6f1b4d0e12c56a586ab639ef96b609f80ffff33ffa0df762fdcd192d4298d1684e2521380eb0fde2cc24cf006ebec2784698a0e3438ff01ffffa0df762fdcd192d4298d1684e2521380eb0fde2cc24cf006ebec2784698a0e3438ffa0df762fdcd192d4298d1684e2521380eb0fde2cc24cf006ebec2784698a0e3438808080ff8080808080" + }, + { + "coin": { + "amount": 736359553, + "parent_coin_info": "0x1362e5089fb72e8e9800c0849a2558e4e27653b307be340586c7668f237ecf67", + "puzzle_hash": "0x4d9b3001eac5106eebe381bae27876bca53bdd9bb025ad76ccb7a79b178d8527" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b08f46dcac5866bef229e326545fa95ce1250fb2b7ff51753e5eee168ada32600c5fa08117f4c7aab3cdc68e55268b536eff018080", + "solution": "0xff80ffff01ffff33ffa0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ff0180ffff33ffa08a3ee8a747703263bb91591abf58929302f0001ae9858734c4cbbfde90ddc2c5ff842bdc536080ffff34ff8307a12080ffff3cffa0b92651fd8cc193716fa1ae7beab6410d696bdbcc0445ad058886c235d9ca3d2280ffff3dffa0592514a6732e2b17fa5acae0b4726ceb3bc8af171af5526835a6ed4a4b7d3f378080ff8080" + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0xba65e7e5a65dbb7184c4b0b4a2e26393339ee1721f89c39974dabdf280f4b6a0", + "puzzle_hash": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9" + }, + "puzzle_reveal": "0xff02ffff01ff04ffff04ff04ffff04ff05ffff04ff0bff80808080ffff04ffff04ff0affff04ffff02ff0effff04ff02ffff04ffff04ff05ffff04ff0bffff04ff17ff80808080ff80808080ff808080ff808080ffff04ffff01ff33ff3cff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff0effff04ff02ffff04ff09ff80808080ffff02ff0effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080", + "solution": "0xffa0ed6e015250481a9046d489fd8954bc77b8c828c33679c5e3c50e7c4dcf7481acff01ff8080" + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0x2356a252436f90c0a2c4fabbcf37126495ffe3672227d0b1748221a791fe71b3", + "puzzle_hash": "0x2b37174f406c23b336cb57d76fafa3e51d6f76c80ee9df06238d74abe6434cbe" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa0146d96a4267dc05f52f01233f1301633597607bc0b0e57aadfb780bb8bfb6360a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff02ff05ff82017f80ffff01ff02ffff03ffff22ffff09ffff02ff7effff04ff02ffff04ff8217ffff80808080ff0b80ffff15ff17ff808080ffff01ff04ffff04ff28ffff04ff82017fff808080ffff04ffff04ff34ffff04ff8202ffffff04ff82017fffff04ffff04ff8202ffff8080ff8080808080ffff04ffff04ff38ffff04ff822fffff808080ffff02ff26ffff04ff02ffff04ff2fffff04ff17ffff04ff8217ffffff04ff822fffffff04ff8202ffffff04ff8205ffffff04ff820bffffff01ff8080808080808080808080808080ffff01ff088080ff018080ff0180ffff04ffff01ffffffff313dff4946ffff0233ff3c04ffffff0101ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff22ff3c80ffff0bff2affff0bff2affff0bff22ff3280ff0980ffff0bff2aff0bffff0bff22ff8080808080ff8080808080ffff010b80ff0180ffffff02ffff03ff17ffff01ff02ffff03ff82013fffff01ff04ffff04ff30ffff04ffff0bffff0bffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ff82023fffff04ff82053fffff04ff820b3fff8080808080808080ffff02ff7effff04ff02ffff04ffff02ff2effff04ff02ffff04ff2fffff04ff5fffff04ff82017fff808080808080ff8080808080ff2f80ff808080ffff02ff26ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fffff04ff5fffff04ff8201bfffff04ff82017fffff04ffff10ff8202ffffff010180ff808080808080808080808080ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff37ffff04ff2fffff04ff5fffff04ff8201bfffff04ff82017fffff04ff8202ffff8080808080808080808080ff0180ffff01ff02ffff03ffff15ff8202ffffff11ff0bffff01018080ffff01ff04ffff04ff20ffff04ff82017fffff04ff5fff80808080ff8080ffff01ff088080ff018080ff0180ff0bff17ffff02ff5effff04ff02ffff04ff09ffff04ff2fffff04ffff02ff7effff04ff02ffff04ffff04ff09ffff04ff0bff1d8080ff80808080ff808080808080ff5f80ffff04ffff0101ffff04ffff04ff2cffff04ff05ff808080ffff04ffff04ff20ffff04ff17ffff04ff0bff80808080ff80808080ffff0bff2affff0bff22ff2480ffff0bff2affff0bff2affff0bff22ff3280ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff22ff2280ff8080808080ffff0bff22ff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff7effff04ff02ffff04ff09ff80808080ffff02ff7effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a9194a2d13a4214667dd02086d583975802b22c060fbaf7b1bea846011fe83f81c3c4ddb9c7c136fddcac09db6c456f8ff018080ffff04ffff01a04bf5122f344554c53bde2ebb8cd2b7e3d1600ad631c385a5d7cce23c7785459affff04ffff0180ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa0146d96a4267dc05f52f01233f1301633597607bc0b0e57aadfb780bb8bfb6360a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff0180ff01808080808080ff01808080", + "solution": "0xffffa0d8f4e74fd7f0e2d4eef0a26a72de1b063178389ad3c8377810eac026b8f0fc38ffa0299988a298a51ab241932fd15c265746c6f1b4d0e12c56a586ab639ef96b609fff0180ff01ffff01ffff80ffff01ffff33ffa0299988a298a51ab241932fd15c265746c6f1b4d0e12c56a586ab639ef96b609fff01ffffa0676b280871ebb40f4d9ee33783bd968946235fd390a28af8409f46e01be69e828080ffff3effa05a3f2718fb6778fdd80836bebfce25f2ea7dc50d184a106f29c307166126c0598080ff80808080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x27099a1eba1b37ac909f338c3881785bedad68ed4fce9ff5ba9cc6f20e4da742", + "puzzle_hash": "0xd168a5d3c814b34c971c547e0339c9efda043c8a405ee0fa548437bcc582a58f" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0b3b8c18b445aff2202778a01447257b7a953d25cdf226b7288afdff16cc83060dee754a245561e9427d3e3f6af129c55ff018080", + "solution": "0xff80ffff01ffff33ffa0c8bff349573c36f246e9d0ff575ed83d08eb62a2adc92171fd2710dae9ce3c1eff8604d146ee054080ffff33ffa0286e4f74c6649320b023a62b53bb9e4915fe32e0d3c83cd7401d2b727e85c41aff8500b9b002b68080ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x7c57d5a47f0e246946e95c7a198e0a1c6184ee954cbfe278d6a841ed8f900825", + "puzzle_hash": "0x3e1fc8eae031f8f2ebda38a6ac482f82ea0562b1896cd03ce102087ab9cf1782" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0926f188463c96e14a8be0e437045b6949bd373076b0c33ff37cd304ed63663fe0d8b3103cd4b13bd9ec7cbb666dcf55cff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0xa127de80737f00575f178614cab953c9377a8a3bd3a40d9ae605eb5590b83b6d", + "puzzle_hash": "0x2c7514437b10ad5fdb046d41758954d997bdaf1f28da1fc25b4da7352ac4ddfe" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0b8222ed2751c84e7c472524fb8f89ba690348344834c41b827036ebb23a35e43eb6edf6975cbbf3927e4c9ce27dfae0cff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x417eabbf596107320ae00731cfe799303527d7fcff0c2ba16dde6aae3ac1f17d", + "puzzle_hash": "0x2c7514437b10ad5fdb046d41758954d997bdaf1f28da1fc25b4da7352ac4ddfe" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0b8222ed2751c84e7c472524fb8f89ba690348344834c41b827036ebb23a35e43eb6edf6975cbbf3927e4c9ce27dfae0cff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x23cc0996b7dfaadc0db67f79945549c70524b2f68a5ca3a4b547d1db64150fa0", + "puzzle_hash": "0xcf987ed9d5f5307f3bde498aee37c6380464a07668c0c65b5ce532f16627555f" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b09374544599c7509966e0244fd162e04d8c8575a301dd8cca471fb67c6d044a2054f833eb6d77e39e1a8c30651cc06babff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x8a3e984e42acbac49fb1d13db3a3299bbb67a81b3e2a17b65415ebfc4775be75", + "puzzle_hash": "0x4e341cfc3819196420dcab03bbe3f38c3db9c2793db9c4071edc792fd2e828f6" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a9ae8537359d306702ab17e6a1e9bd2015f7f7a5170a167eb9dd7cbef272881364d5fbb8e3266a7ff8c287fc45b13624ff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x7032877041d3c56f7c2c3e2173c08303ecb747bc2891c3701e664f33cd3e211c", + "puzzle_hash": "0x4e341cfc3819196420dcab03bbe3f38c3db9c2793db9c4071edc792fd2e828f6" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a9ae8537359d306702ab17e6a1e9bd2015f7f7a5170a167eb9dd7cbef272881364d5fbb8e3266a7ff8c287fc45b13624ff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x14be86b0087a21d09862e829ec266d5d5e82bd0e7981831f44fe986fa57caa72", + "puzzle_hash": "0x4e341cfc3819196420dcab03bbe3f38c3db9c2793db9c4071edc792fd2e828f6" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a9ae8537359d306702ab17e6a1e9bd2015f7f7a5170a167eb9dd7cbef272881364d5fbb8e3266a7ff8c287fc45b13624ff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x8a3e984e42acbac49fb1d13db3a3299bbb67a81b3e2a17b65415ebfc4775be75", + "puzzle_hash": "0xbca855e6d2d32f89fa78f29f4c5e5cf7133624086f08584efbb2414c25584e5e" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a37e5d7f5a72b5faaa3d0591ff68119372dde5faddfa4b7168e1bee0cbfbc0ddd713059690e93b690c98f958f3d4986aff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 530000000000, + "parent_coin_info": "0x7032877041d3c56f7c2c3e2173c08303ecb747bc2891c3701e664f33cd3e211c", + "puzzle_hash": "0xbca855e6d2d32f89fa78f29f4c5e5cf7133624086f08584efbb2414c25584e5e" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0a37e5d7f5a72b5faaa3d0591ff68119372dde5faddfa4b7168e1bee0cbfbc0ddd713059690e93b690c98f958f3d4986aff018080", + "solution": "0xff80ffff0180ff8080" + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0x22508d0a2e0f5d44b4d32f9c824af306455721de200828e9b4d2ba8df5d9da8f", + "puzzle_hash": "0x118ca4603ed3846ab159c52c8fedada2a9471f207079349b5843aff032865844" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fffff010180ffff01ff02ff36ffff04ff02ffff04ff05ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff0bff80808080ffff04ff2fffff04ff0bffff04ff5fff808080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4602ff3304ffff0101ff02ffff02ffff03ff05ffff01ff02ff5cffff04ff02ffff04ff0dffff04ffff0bff2cffff0bff24ff3880ffff0bff2cffff0bff2cffff0bff24ff3480ff0980ffff0bff2cff0bffff0bff24ff8080808080ff8080808080ffff010b80ff0180ff02ffff03ff0bffff01ff02ff32ffff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ffff02ff2affff04ff02ffff04ffff02ffff03ffff09ff23ff2880ffff0181b3ff8080ff0180ff80808080ff80808080808080ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffffff0bffff0bff17ffff02ff3affff04ff02ffff04ff09ffff04ff2fffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ff5f80ff0bff81bf80ff02ffff03ffff20ffff22ff4fff178080ffff01ff02ff7effff04ff02ffff04ff6fffff04ffff04ffff02ffff03ff4fffff01ff04ff23ffff04ffff02ff3affff04ff02ffff04ff09ffff04ff53ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff81b3ff80808080ffff011380ff0180ffff02ff7cffff04ff02ffff04ff05ffff04ff1bffff04ffff21ff4fff1780ff80808080808080ff8080808080ffff01ff088080ff0180ffff04ffff09ffff18ff05ffff010180ffff010180ffff09ff05ffff01818f8080ff0bff2cffff0bff24ff3080ffff0bff2cffff0bff2cffff0bff24ff3480ff0580ffff0bff2cffff02ff5cffff04ff02ffff04ff07ffff04ffff0bff24ff2480ff8080808080ffff0bff24ff8080808080ffffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff26ffff04ff02ffff04ff09ff80808080ffff02ff26ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ff5effff04ff02ffff04ff05ffff04ff0bffff04ffff02ff3affff04ff02ffff04ff09ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfff80808080808080808080ffff04ffff04ff20ffff04ff17ff808080ffff02ff7cffff04ff02ffff04ff05ffff04ffff02ff82017fffff04ffff04ffff04ff17ff2f80ffff04ffff04ff5fff81bf80ffff04ff0bff05808080ff8202ff8080ffff01ff80808080808080ffff02ff2effff04ff02ffff04ff05ffff04ff0bffff04ffff02ffff03ff3bffff01ff02ff22ffff04ff02ffff04ff05ffff04ff17ffff04ff13ffff04ff2bffff04ff5bffff04ff5fff808080808080808080ffff01ff02ffff03ffff09ff15ffff0bff13ff1dff2b8080ffff01ff0bff15ff17ff5f80ffff01ff088080ff018080ff0180ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfffff04ff82017fff8080808080808080808080ff02ffff03ff05ffff011bffff010b80ff0180ff018080ffff04ffff01ffa024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffa062f683c01a2933cfed83a5920dac2c4038880ccaa4fc1a32464db9e84e83bbb1a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff8202ffffff01ff02ff16ffff04ff02ffff04ff05ffff04ff8204bfffff04ff8206bfffff04ff82017fffff04ffff0bffff19ff2fffff18ffff019100ffffffffffffffffffffffffffffffffff8202ff8080ff0bff82017f80ff8080808080808080ffff01ff04ffff04ff08ffff04ff17ffff04ffff02ff1effff04ff02ffff04ff82017fff80808080ff80808080ffff04ffff04ff1cffff04ff5fffff04ff8206bfff80808080ff80808080ff0180ffff04ffff01ffff32ff3d33ff3effff04ffff04ff1cffff04ff0bffff04ff17ff80808080ffff04ffff04ff1cffff04ff05ffff04ff2fff80808080ffff04ffff04ff0affff04ff5fff808080ffff04ffff04ff14ffff04ffff0bff5fffff012480ff808080ff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a02f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57ffff04ffff01a02b228f0ffc5ec6c6736e946f128e9c2fbd71899c99253acedaaee330aa2719e6ffff04ffff01b085b6ca7ad8fe553ea4db4ee5426f84ddb0bfe2a50ba48445011cab09d6962188a74d7bf3aeadb9fa3bfa54c7a91b2550ffff04ffff01a0ccd5bb71183532bff220ba46c268991a00000000000000000000000000000000ffff04ffff01a0f094569dc7791a67f10f20b259366aed386159f01342bff918b87be1652e7665ff01808080808080ff01808080", + "solution": "0xffffa0885881cb60698d7b37b907aae29b7e5a992df0e58ce51266c3c75a05fa74c233ffa0aad9366d43fa15566bd53e6a2ed1bd35b8a2c67fbb7056e4490935c9358e0a2eff0180ff01ffff8601977420dc00ff8332c0e78080" + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032c0e7", + "puzzle_hash": "0x2b228f0ffc5ec6c6736e946f128e9c2fbd71899c99253acedaaee330aa2719e6" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff82017fffff01ff04ffff04ff38ffff04ffff0bffff02ff2effff04ff02ffff04ff05ffff04ff81bfffff04ffff02ff3effff04ff02ffff04ffff04ff05ffff04ff0bff178080ff80808080ff808080808080ff82017f80ff808080ffff04ffff04ff3cffff01ff248080ffff04ffff04ff28ffff04ff82017fff808080ff80808080ffff01ff04ffff04ff24ffff04ff2fff808080ffff04ffff04ff2cffff04ff5fffff04ff81bfff80808080ffff04ffff04ff10ffff04ff81bfff808080ff8080808080ff0180ffff04ffff01ffffff49ff463fffff5002ff333cffff04ff0101ffff02ff02ffff03ff05ffff01ff02ff36ffff04ff02ffff04ff0dffff04ffff0bff26ffff0bff2aff1280ffff0bff26ffff0bff26ffff0bff2aff3a80ff0980ffff0bff26ff0bffff0bff2aff8080808080ff8080808080ffff010b80ff0180ffff0bff26ffff0bff2aff3480ffff0bff26ffff0bff26ffff0bff2aff3a80ff0580ffff0bff26ffff02ff36ffff04ff02ffff04ff07ffff04ffff0bff2aff2a80ff8080808080ffff0bff2aff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffff04ffff01a062f683c01a2933cfed83a5920dac2c4038880ccaa4fc1a32464db9e84e83bbb1ffff04ffff01a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff0183093a80ffff04ffff01a0627d8b6f20070616d768cd0e255630aa4e9fae53cb9fa2039a02e44a4d65ded1ff01808080808080", + "solution": "0xffa0aad9366d43fa15566bd53e6a2ed1bd35b8a2c67fbb7056e4490935c9358e0a2effa01252d6301b1373ab1bc84d32771e61730ee9cecf5d78aef1ba0257b34823d8cc80" + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0xcfdb607cf0981b21a830f53085051e7f7e7d29ed3626aa31c66e2b8d662a92e8", + "puzzle_hash": "0xb7809f2891ee38d4674cf547e701a15aebe285ad4526f13abd152777f0363c9b" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fffff010180ffff01ff02ff36ffff04ff02ffff04ff05ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff0bff80808080ffff04ff2fffff04ff0bffff04ff5fff808080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4602ff3304ffff0101ff02ffff02ffff03ff05ffff01ff02ff5cffff04ff02ffff04ff0dffff04ffff0bff2cffff0bff24ff3880ffff0bff2cffff0bff2cffff0bff24ff3480ff0980ffff0bff2cff0bffff0bff24ff8080808080ff8080808080ffff010b80ff0180ff02ffff03ff0bffff01ff02ff32ffff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ffff02ff2affff04ff02ffff04ffff02ffff03ffff09ff23ff2880ffff0181b3ff8080ff0180ff80808080ff80808080808080ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffffff0bffff0bff17ffff02ff3affff04ff02ffff04ff09ffff04ff2fffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ff5f80ff0bff81bf80ff02ffff03ffff20ffff22ff4fff178080ffff01ff02ff7effff04ff02ffff04ff6fffff04ffff04ffff02ffff03ff4fffff01ff04ff23ffff04ffff02ff3affff04ff02ffff04ff09ffff04ff53ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff81b3ff80808080ffff011380ff0180ffff02ff7cffff04ff02ffff04ff05ffff04ff1bffff04ffff21ff4fff1780ff80808080808080ff8080808080ffff01ff088080ff0180ffff04ffff09ffff18ff05ffff010180ffff010180ffff09ff05ffff01818f8080ff0bff2cffff0bff24ff3080ffff0bff2cffff0bff2cffff0bff24ff3480ff0580ffff0bff2cffff02ff5cffff04ff02ffff04ff07ffff04ffff0bff24ff2480ff8080808080ffff0bff24ff8080808080ffffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff26ffff04ff02ffff04ff09ff80808080ffff02ff26ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ff5effff04ff02ffff04ff05ffff04ff0bffff04ffff02ff3affff04ff02ffff04ff09ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfff80808080808080808080ffff04ffff04ff20ffff04ff17ff808080ffff02ff7cffff04ff02ffff04ff05ffff04ffff02ff82017fffff04ffff04ffff04ff17ff2f80ffff04ffff04ff5fff81bf80ffff04ff0bff05808080ff8202ff8080ffff01ff80808080808080ffff02ff2effff04ff02ffff04ff05ffff04ff0bffff04ffff02ffff03ff3bffff01ff02ff22ffff04ff02ffff04ff05ffff04ff17ffff04ff13ffff04ff2bffff04ff5bffff04ff5fff808080808080808080ffff01ff02ffff03ffff09ff15ffff0bff13ff1dff2b8080ffff01ff0bff15ff17ff5f80ffff01ff088080ff018080ff0180ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfffff04ff82017fff8080808080808080808080ff02ffff03ff05ffff011bffff010b80ff0180ff018080ffff04ffff01ffa024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffa0fbe278647d77cfa9cc367dc46a0a2230ecb74881751b7352e8b1555f6b65119aa0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff8202ffffff01ff02ff16ffff04ff02ffff04ff05ffff04ff8204bfffff04ff8206bfffff04ff82017fffff04ffff0bffff19ff2fffff18ffff019100ffffffffffffffffffffffffffffffffff8202ff8080ff0bff82017f80ff8080808080808080ffff01ff04ffff04ff08ffff04ff17ffff04ffff02ff1effff04ff02ffff04ff82017fff80808080ff80808080ffff04ffff04ff1cffff04ff5fffff04ff8206bfff80808080ff80808080ff0180ffff04ffff01ffff32ff3d33ff3effff04ffff04ff1cffff04ff0bffff04ff17ff80808080ffff04ffff04ff1cffff04ff05ffff04ff2fff80808080ffff04ffff04ff0affff04ff5fff808080ffff04ffff04ff14ffff04ffff0bff5fffff012480ff808080ff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a00d82c2e32037b77da9c8fdd5d1d4fa4b8cfa08026d2c04834906b741fdcb6fe2ffff04ffff01a0de1cebdefa5507814b23d1b7f8cf41e30c0208e2e0c0b6d968b44671bd663323ffff04ffff01b0b746642357c8bbb292232257939c014264375de69527b0010b66c2e491eac1bbbc50492ab098fa32085d679cb0712ccdffff04ffff01a0ccd5bb71183532bff220ba46c268991a00000000000000000000000000000000ffff04ffff01a01b1ae4195e0c19c8f10ecf4f10cad340d76111e2bcdb50a6724daf9b5e14b9b5ff01808080808080ff01808080", + "solution": "0xffffa0bedcd555f85af67268598c0e4bc381bd3e9c89798ee6537de1c8d9814ca470f1ffa0c93ede910a929b8c811bbb935f410e64a0bd48f0cd45af4bb3bc7e84b0e79c38ff0180ff01ffff8601977420dc00ff8332c0f18080" + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032c0f1", + "puzzle_hash": "0xde1cebdefa5507814b23d1b7f8cf41e30c0208e2e0c0b6d968b44671bd663323" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff82017fffff01ff04ffff04ff38ffff04ffff0bffff02ff2effff04ff02ffff04ff05ffff04ff81bfffff04ffff02ff3effff04ff02ffff04ffff04ff05ffff04ff0bff178080ff80808080ff808080808080ff82017f80ff808080ffff04ffff04ff3cffff01ff248080ffff04ffff04ff28ffff04ff82017fff808080ff80808080ffff01ff04ffff04ff24ffff04ff2fff808080ffff04ffff04ff2cffff04ff5fffff04ff81bfff80808080ffff04ffff04ff10ffff04ff81bfff808080ff8080808080ff0180ffff04ffff01ffffff49ff463fffff5002ff333cffff04ff0101ffff02ff02ffff03ff05ffff01ff02ff36ffff04ff02ffff04ff0dffff04ffff0bff26ffff0bff2aff1280ffff0bff26ffff0bff26ffff0bff2aff3a80ff0980ffff0bff26ff0bffff0bff2aff8080808080ff8080808080ffff010b80ff0180ffff0bff26ffff0bff2aff3480ffff0bff26ffff0bff26ffff0bff2aff3a80ff0580ffff0bff26ffff02ff36ffff04ff02ffff04ff07ffff04ffff0bff2aff2a80ff8080808080ffff0bff2aff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffff04ffff01a0fbe278647d77cfa9cc367dc46a0a2230ecb74881751b7352e8b1555f6b65119affff04ffff01a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff0183093a80ffff04ffff01a03432b8b1e4d282309e5afb9f7a3237fd4c6f03bce0e676ad212597fc7eb0ca63ff01808080808080", + "solution": "0xffa0c93ede910a929b8c811bbb935f410e64a0bd48f0cd45af4bb3bc7e84b0e79c38ffa07f0d9ab105582020c410f70071e1f9dea3a1ea4d3b9e57d6a74f431e195be59c80" + }, + { + "coin": { + "amount": 1, + "parent_coin_info": "0xd7abe18a1cbbfd51f760d951704eff11c3e8dbad92f021dcbfa2846d1a3a0f8e", + "puzzle_hash": "0xff2c7da1e4bc136e529c0769907695f57059b78e9e51ba9a69f5d83b1de3a656" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fffff010180ffff01ff02ff36ffff04ff02ffff04ff05ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff0bff80808080ffff04ff2fffff04ff0bffff04ff5fff808080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4602ff3304ffff0101ff02ffff02ffff03ff05ffff01ff02ff5cffff04ff02ffff04ff0dffff04ffff0bff2cffff0bff24ff3880ffff0bff2cffff0bff2cffff0bff24ff3480ff0980ffff0bff2cff0bffff0bff24ff8080808080ff8080808080ffff010b80ff0180ff02ffff03ff0bffff01ff02ff32ffff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ffff02ff2affff04ff02ffff04ffff02ffff03ffff09ff23ff2880ffff0181b3ff8080ff0180ff80808080ff80808080808080ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffffff0bffff0bff17ffff02ff3affff04ff02ffff04ff09ffff04ff2fffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ff5f80ff0bff81bf80ff02ffff03ffff20ffff22ff4fff178080ffff01ff02ff7effff04ff02ffff04ff6fffff04ffff04ffff02ffff03ff4fffff01ff04ff23ffff04ffff02ff3affff04ff02ffff04ff09ffff04ff53ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff81b3ff80808080ffff011380ff0180ffff02ff7cffff04ff02ffff04ff05ffff04ff1bffff04ffff21ff4fff1780ff80808080808080ff8080808080ffff01ff088080ff0180ffff04ffff09ffff18ff05ffff010180ffff010180ffff09ff05ffff01818f8080ff0bff2cffff0bff24ff3080ffff0bff2cffff0bff2cffff0bff24ff3480ff0580ffff0bff2cffff02ff5cffff04ff02ffff04ff07ffff04ffff0bff24ff2480ff8080808080ffff0bff24ff8080808080ffffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff26ffff04ff02ffff04ff09ff80808080ffff02ff26ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ff5effff04ff02ffff04ff05ffff04ff0bffff04ffff02ff3affff04ff02ffff04ff09ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfff80808080808080808080ffff04ffff04ff20ffff04ff17ff808080ffff02ff7cffff04ff02ffff04ff05ffff04ffff02ff82017fffff04ffff04ffff04ff17ff2f80ffff04ffff04ff5fff81bf80ffff04ff0bff05808080ff8202ff8080ffff01ff80808080808080ffff02ff2effff04ff02ffff04ff05ffff04ff0bffff04ffff02ffff03ff3bffff01ff02ff22ffff04ff02ffff04ff05ffff04ff17ffff04ff13ffff04ff2bffff04ff5bffff04ff5fff808080808080808080ffff01ff02ffff03ffff09ff15ffff0bff13ff1dff2b8080ffff01ff0bff15ff17ff5f80ffff01ff088080ff018080ff0180ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfffff04ff82017fff8080808080808080808080ff02ffff03ff05ffff011bffff010b80ff0180ff018080ffff04ffff01ffa024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffa0a1485b353675381d6d93f428e64059f26a3911aefab09c3c2ea4af46da313f7ba0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff8202ffffff01ff02ff16ffff04ff02ffff04ff05ffff04ff8204bfffff04ff8206bfffff04ff82017fffff04ffff0bffff19ff2fffff18ffff019100ffffffffffffffffffffffffffffffffff8202ff8080ff0bff82017f80ff8080808080808080ffff01ff04ffff04ff08ffff04ff17ffff04ffff02ff1effff04ff02ffff04ff82017fff80808080ff80808080ffff04ffff04ff1cffff04ff5fffff04ff8206bfff80808080ff80808080ff0180ffff04ffff01ffff32ff3d33ff3effff04ffff04ff1cffff04ff0bffff04ff17ff80808080ffff04ffff04ff1cffff04ff05ffff04ff2fff80808080ffff04ffff04ff0affff04ff5fff808080ffff04ffff04ff14ffff04ffff0bff5fffff012480ff808080ff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a02f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57ffff04ffff01a031e7f94e0d8ef2d7b34d04b164f78d423d5df9584e00c83e1357ba73a80d047affff04ffff01b08099178acf697d93edc498d34818a75bcaa9bafa4244a5e7930665d0476dad110541c6e8de416cf3c351bc55974300c7ffff04ffff01a0ccd5bb71183532bff220ba46c268991a00000000000000000000000000000000ffff04ffff01a0368f757ddde5ecd7411426178a2d5ce0e469a6cf2184854643f526d2e1b53c81ff01808080808080ff01808080", + "solution": "0xffffa0b3ad0be083e43f539d27152ab79c35f8515072960854883a1619c838346e7869ffa0afab0e5a027d7becdf94677d55f9f3812e959c6b484132edb67a12f1cb70d82fff0180ff01ffff8601977420dc00ff8332c0ed8080" + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a0000000000000000000000000032c0ed", + "puzzle_hash": "0x31e7f94e0d8ef2d7b34d04b164f78d423d5df9584e00c83e1357ba73a80d047a" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff82017fffff01ff04ffff04ff38ffff04ffff0bffff02ff2effff04ff02ffff04ff05ffff04ff81bfffff04ffff02ff3effff04ff02ffff04ffff04ff05ffff04ff0bff178080ff80808080ff808080808080ff82017f80ff808080ffff04ffff04ff3cffff01ff248080ffff04ffff04ff28ffff04ff82017fff808080ff80808080ffff01ff04ffff04ff24ffff04ff2fff808080ffff04ffff04ff2cffff04ff5fffff04ff81bfff80808080ffff04ffff04ff10ffff04ff81bfff808080ff8080808080ff0180ffff04ffff01ffffff49ff463fffff5002ff333cffff04ff0101ffff02ff02ffff03ff05ffff01ff02ff36ffff04ff02ffff04ff0dffff04ffff0bff26ffff0bff2aff1280ffff0bff26ffff0bff26ffff0bff2aff3a80ff0980ffff0bff26ff0bffff0bff2aff8080808080ff8080808080ffff010b80ff0180ffff0bff26ffff0bff2aff3480ffff0bff26ffff0bff26ffff0bff2aff3a80ff0580ffff0bff26ffff02ff36ffff04ff02ffff04ff07ffff04ffff0bff2aff2a80ff8080808080ffff0bff2aff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffff04ffff01a0a1485b353675381d6d93f428e64059f26a3911aefab09c3c2ea4af46da313f7bffff04ffff01a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff0183093a80ffff04ffff01a074556bdb1f184e19ed982fae921fea02e3b226110124cc87679b656138ec2c04ff01808080808080", + "solution": "0xffa0afab0e5a027d7becdf94677d55f9f3812e959c6b484132edb67a12f1cb70d82fffa05cbe698351c3f79dd2a4223f5eaa504b4fe3edc42daa66ad6f69f96a6aca18c380" + }, + + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_block_spends_with_conditions` + +Functionality: Retrieves every coin that was spent in a block, along with the condition(s) used for the spends. Requires the header hash of the block to retrieve + +Usage: chia rpc full_node [OPTIONS] get_block_spends_with_conditions [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------- | :--------- | :------- | :------------------------ | +| header_hash | HEX STRING | True | The block's `header_hash` | + +:::note + +Keep in mind that most blocks do not contain any transactions. These blocks will simply return "[]" for this request. + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_block_spends_with_conditions '{"header_hash": "0x0e2adf947b9165298bfb297c5142e9b5ad75ae922052bc95d5ab1b19f2824797"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "block_spends_with_conditions": [ + { + "coin_spend": { + "coin": { + "amount": 999690000000, + "parent_coin_info": "0x703a3e088f95d3a62e73a66a9584cb20867a320e5add58d18cc664ca0888c9b6", + "puzzle_hash": "0xa46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0b93e1797a30d4a5c643d2c39aacc6c4ef92f0add94f119a912f7b2f0476e754af692a794e65c6db156f15006e659b0d0ff018080", + "solution": "0xff80ffff01ffff3dffa0088f6e1110922010aba178de9bb93a213a876dd5cfac1ce9341e975c976d418b8080ff8080" + }, + "conditions": [ + { + "opcode": "0x32", + "vars": [ + "b93e1797a30d4a5c643d2c39aacc6c4ef92f0add94f119a912f7b2f0476e754af692a794e65c6db156f15006e659b0d0", + "bba12a2add1b977b93dbb6dfc1b926e5fb00e001a5d39d3747045d74552d6989" + ] + }, + { + "opcode": "0x3d", + "vars": [ + "088f6e1110922010aba178de9bb93a213a876dd5cfac1ce9341e975c976d418b" + ] + } + ] + }, + { + "coin_spend": { + "coin": { + "amount": 1000000000000, + "parent_coin_info": "0x0e61b80f50c487302f510874c6fd8af09dd326fce8b09d189ab35bb55c25630a", + "puzzle_hash": "0xa46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0b93e1797a30d4a5c643d2c39aacc6c4ef92f0add94f119a912f7b2f0476e754af692a794e65c6db156f15006e659b0d0ff018080", + "solution": "0xff80ffff01ffff33ffa0a46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504bff8600e8d4a5100080ffff33ffa0edaff8854520d4dda9bcd7cedeafcd05d3992a6600583fd8d0220070a464ea06ff8600e8c1cf490080ffff34ff835b8d8080ffff3cffa05566d91832d2bd683bfb05f96ff3bb959b84e25bb7bea74406c1487ad126936d8080ff8080" + }, + "conditions": [ + { + "opcode": "0x32", + "vars": [ + "b93e1797a30d4a5c643d2c39aacc6c4ef92f0add94f119a912f7b2f0476e754af692a794e65c6db156f15006e659b0d0", + "7707e7bd19e2614ede91ed56346bd8cd18386f2f5870d000b5f7db52756448ad" + ] + }, + { + "opcode": "0x33", + "vars": [ + "a46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b", + "00e8d4a51000" + ] + }, + { + "opcode": "0x33", + "vars": [ + "edaff8854520d4dda9bcd7cedeafcd05d3992a6600583fd8d0220070a464ea06", + "00e8c1cf4900" + ] + }, + { + "opcode": "0x34", + "vars": ["5b8d80"] + }, + { + "opcode": "0x3c", + "vars": [ + "5566d91832d2bd683bfb05f96ff3bb959b84e25bb7bea74406c1487ad126936d" + ] + } + ] + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_coin_records_by_hint` + +Functionality: Retrieves coins by hint; by default only returns unspent coins + +Usage: chia rpc full_node [OPTIONS] get_coin_records_by_hint [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------------------------------------ | :--------- | :------- | :------------------------------------------------------------------------------------- | +| hint | HEX STRING | True | The hint to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | +| include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_coin_records_by_hint '{"start_height": 400000, "end_height": 1900000, "include_spent_coins": true, "hint": "0x6916079cc35f377e96fa34af87d14f58ce1f08d864f93e89bbdd04a26f591540"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "coin_records": [ + { + "coin": { + "amount": 10000, + "parent_coin_info": "0x13eb187994e143a122c868d47e3e1201ddaf8fbaee13e6b04293ff527ec7b8e8", + "puzzle_hash": "0xd229b55df95852e99f1c2708a7248380676ead58fd6a3cbfb44c870204506751" + }, + "coinbase": false, + "confirmed_block_index": 1868037, + "spent": true, + "spent_block_index": 1868399, + "timestamp": 1650533680 + }, + { + "coin": { + "amount": 10000, + "parent_coin_info": "0x7fcc1791720603314f134cf47dc80c2d36bae1dd236eada570993d285f7437a5", + "puzzle_hash": "0xd229b55df95852e99f1c2708a7248380676ead58fd6a3cbfb44c870204506751" + }, + "coinbase": false, + "confirmed_block_index": 1872712, + "spent": true, + "spent_block_index": 1873218, + "timestamp": 1650620445 + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_coin_records_by_names` + +Functionality: Retrieves the coins for given coin IDs; by default only returns unspent coins + +Usage: chia rpc full_node [OPTIONS] get_coin_records_by_names [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------------------------------------ | :--------------- | :------- | :------------------------------------------------------------------------------------- | +| names | HEX STRING ARRAY | True | A list of coin_ids to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | +| include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_coin_records_by_names '{"start_height": 400000, "end_height": 1900000, "include_spent_coins": true, "names":["0x83103a520d363d9356d2bba5be786f56ca83cdccdaad1f7db74cabe3a6ec6195", "0x3a071ea8bb51d724bf3841fae40370ff18fe1e71a890b731ed1e67f026550995"]}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "coin_records": [ + { + "coin": { + "amount": 126, + "parent_coin_info": "0x6a16808f534325b809df04f64277c84b7e6f3d01b84ba7146858e3546ab97db4", + "puzzle_hash": "0x8949f28258c35e47dceebf3a14a206c389ec1b85261ba217688e7b8303eb9b0f" + }, + "coinbase": false, + "confirmed_block_index": 1856394, + "spent": true, + "spent_block_index": 1872533, + "timestamp": 1650315703 + }, + { + "coin": { + "amount": 7180937600000, + "parent_coin_info": "0x459d10d2d2c9eef036825b7b4a8a7618b0e3137641ab6abde515c0af0ddf9f85", + "puzzle_hash": "0xabd433d8744b06a4cf2b5872a951bf66358af6f6bcb54075a85708aff6e90ed8" + }, + "coinbase": false, + "confirmed_block_index": 472449, + "spent": true, + "spent_block_index": 472472, + "timestamp": 1624450760 + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_coin_records_by_parent_ids` + +Functionality: Retrieves the coins for given parent coin IDs; by default only returns unspent coins + +Usage: chia rpc full_node [OPTIONS] get_coin_records_by_parent_ids [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------------------------------------ | :--------------- | :------- | :------------------------------------------------------------------------------------- | +| parent_ids | HEX STRING ARRAY | True | A list of parent IDs to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | +| include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_coin_records_by_parent_ids '{"start_height":4, "end_height": 1900000, "include_spent_coins": true, "parent_ids": ["0x83103a520d363d9356d2bba5be786f56ca83cdccdaad1f7db74cabe3a6ec6195", "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061"]}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "coin_records": [ + { + "coin": { + "amount": 6164491200000, + "parent_coin_info": "0x83103a520d363d9356d2bba5be786f56ca83cdccdaad1f7db74cabe3a6ec6195", + "puzzle_hash": "0xfbefc3b96a0c2d1dfe8f4dce7c546fd849a3b0b5cf4d75a794f07ac6bb96a80e" + }, + "coinbase": false, + "confirmed_block_index": 472472, + "spent": true, + "spent_block_index": 472488, + "timestamp": 1624451109 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061", + "puzzle_hash": "0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588" + }, + "coinbase": true, + "confirmed_block_index": 101, + "spent": true, + "spent_block_index": 341109, + "timestamp": 1616164827 + }, + { + "coin": { + "amount": 1016446400000, + "parent_coin_info": "0x83103a520d363d9356d2bba5be786f56ca83cdccdaad1f7db74cabe3a6ec6195", + "puzzle_hash": "0x4ed688a013a7059d3619440c6f73d9c3759cdd8c55ece7ec86ded295aa2da8fe" + }, + "coinbase": false, + "confirmed_block_index": 472472, + "spent": true, + "spent_block_index": 2472263, + "timestamp": 1624451109 + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_coin_records_by_puzzle_hash` + +Functionality: Retrieves a list of coin records with a certain puzzle hash + +Usage: chia rpc full_node [OPTIONS] get_coin_records_by_puzzle_hash [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------------------------------------ | :--------- | :------- | :------------------------------------------------------------------------------------- | +| puzzle_hash | HEX STRING | True | The puzzle hash to search for | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | +| include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_coin_records_by_puzzle_hash '{"puzzle_hash": "0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3", "start_height": 3343000, "end_height": 3343335, "include_spent_coins": true}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "coin_records": [ + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xd13487ef15fb62b578fa9bb5fce8b97fbcb4b3d954827ab4a31561ea3cb1e460", + "puzzle_hash": "0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3" + }, + "coinbase": false, + "confirmed_block_index": 3343284, + "spent": true, + "spent_block_index": 3343449, + "timestamp": 1678152756 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0x210a46e3b3460ab75383de012f0085a88aa4559a1f40e1e55da9346e90594120", + "puzzle_hash": "0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3" + }, + "coinbase": false, + "confirmed_block_index": 3343197, + "spent": true, + "spent_block_index": 3343449, + "timestamp": 1678151268 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xb4b179b58837b7a6ca3012495844d345d7f6059fd11f9aa5ccfd64ba598729ea", + "puzzle_hash": "0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3" + }, + "coinbase": false, + "confirmed_block_index": 3343293, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678152889 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xfc0569d4aa5a573efdbeedc4a4e496daff8ded20c9d799261e07c88dd529944a", + "puzzle_hash": "0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3" + }, + "coinbase": false, + "confirmed_block_index": 3343050, + "spent": true, + "spent_block_index": 3343240, + "timestamp": 1678148511 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0x9af31c8e1f5cf2af216f807cf42e84d92c436d91617724e117e9effbc13c9e34", + "puzzle_hash": "0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3" + }, + "coinbase": false, + "confirmed_block_index": 3343334, + "spent": true, + "spent_block_index": 3343449, + "timestamp": 1678153722 + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_coin_records_by_puzzle_hashes` + +Functionality: Retrieves the coins for a given puzzlehashes; by default only returns unspent coins + +Usage: chia rpc full_node [OPTIONS] get_coin_records_by_puzzle_hashes [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------------------------------------ | :--------------- | :------- | :------------------------------------------------------------------------------------- | +| puzzle_hashes | HEX STRING ARRAY | True | An array of puzzle hashes to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | +| include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_coin_records_by_puzzle_hashes '{"puzzle_hashes": ["0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3", "0x71c79abd24b6cf63a92a5d8d1ca88014fd3b39cb3c300876370aac477a13b598"], "start_height": 3343293, "end_height": 3343380, "include_spent_coins": false}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "coin_records": [ + { + "coin": { + "amount": 2499841800000, + "parent_coin_info": "0x0c614ccc3714b6e9c21846aae8019d85e1dd4dcd4a2ba58149aefd94bb745db3", + "puzzle_hash": "0x71c79abd24b6cf63a92a5d8d1ca88014fd3b39cb3c300876370aac477a13b598" + }, + "coinbase": false, + "confirmed_block_index": 3343375, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678154445 + }, + { + "coin": { + "amount": 2416791265997, + "parent_coin_info": "0x605dd680d2cf4714c022348b1f591641a1d31154c6e5e8d87051e34716f43cfb", + "puzzle_hash": "0x71c79abd24b6cf63a92a5d8d1ca88014fd3b39cb3c300876370aac477a13b598" + }, + "coinbase": false, + "confirmed_block_index": 3343378, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678154484 + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xb4b179b58837b7a6ca3012495844d345d7f6059fd11f9aa5ccfd64ba598729ea", + "puzzle_hash": "0x6bde1e0c6f9d3b93dc5e7e878723257ede573deeed59e3b4a90f5c86de1a0bd3" + }, + "coinbase": false, + "confirmed_block_index": 3343293, + "spent": false, + "spent_block_index": 0, + "timestamp": 1678152889 + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_coin_record_by_name` + +Functionality: Retrieves a coin record by its name or coin ID + +Usage: chia rpc full_node [OPTIONS] get_coin_record_by_name [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :--- | :--------- | :------- | :---------------------------------- | +| name | HEX STRING | True | The coin ID or coin name to look up | + +:::note + +The `name` (coin ID) can be obtained by hashing the Coin object: `sha256(parent coin + puzzle hash + amount)` + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_coin_record_by_name '{"name": "0x7a639649fa2b6b4233cab7bf98b3da01be182afba622eb377011ac0940cd83c8"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "coin_record": { + "coin": { + "amount": 82488031983, + "parent_coin_info": "0xfdc7526bfc5107e000b4f710c8c5944f11f4e7ce9711c522b6040bc473266313", + "puzzle_hash": "0x5198fccb3ca8f14c32a5f05ac50c98209defd2d3ed3ee2a17789a9f6fd7d433b" + }, + "coinbase": false, + "confirmed_block_index": 3339400, + "spent": true, + "spent_block_index": 3339504, + "timestamp": 1678080343 + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_fee_estimate` + +Functionality: Obtain an estimated fee for one or more targeted times for a transaction to be included in the blockchain. + +Usage: chia rpc wallet [OPTIONS] get_fee_estimate [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +| -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Parameter | Type | Required | Description | +| :-------------------------------- | :------------ | :------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| spend_bundle | FILENAME | True\* | The spend bundle file (in json format) for which to estimate the fee (\* Exactly one of `spend_bundle` or `cost` must be specified) | +| cost | INTEGER | True\* | The CLVM cost for which to estimate the fee (\* Exactly one of `spend_bundle` or `cost` must be specified) | +| target_times | INTEGER ARRAY | True | An array of the targeted times for transaction inclusion, in seconds. Each targeted time must be at least 0 | + +:::note + +- If `spend_bundle` is specified, then the cost of that spend bundle will first be obtained, followed by obtaining the estimated fee for that cost. Therefore, it is computationally cheaper to use `cost` than it is to use `spend_bundle`, other other factors being equal. +- This RPC takes into account the current size of the mempool relative to its maximum size, as well as the fee in mojos per cost (5 by default) + +::: + +
+Example + +Obtain a fee estimate for a spendbundle with a CLVM cost of 20 million. Targeted inclusion times are 1, 5, and 10 minutes. + +Note that this example was completed at a time when the mempool was not busy, so the fee estimates are all `0`. + +````mdx-code-block +```json +chia rpc full_node get_fee_estimate '{"cost":20000000, "target_times": [60, 300, 600]}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "current_fee_rate": 0.0342163071650677, + "estimates": [684326.1433013539, 4077.432021994343, 4077.432021994343], + "fee_rate_last_block": 0.0, + "fees_last_block": 0, + "full_node_synced": true, + "last_block_cost": 0, + "last_peak_timestamp": 1678171577, + "last_tx_block_height": 3344316, + "mempool_fees": 2, + "mempool_max_size": 550000000000, + "mempool_size": 987358370, + "node_time_utc": 1678171623, + "num_spends": 13, + "peak_height": 3344316, + "success": true, + "target_times": [60, 300, 600] +} +``` +```` + +
+ +--- + +### `get_mempool_item_by_tx_id` + +Functionality: Gets a mempool item by tx id + +Usage: chia rpc full_node [OPTIONS] get_mempool_item_by_tx_id [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------- | :--------- | :------- | :------------------------------------------------------------------------------ | +| tx_id | HEX STRING | True | The spend bundle hash (tx ID) for which to retrieve the item | + +
+Example + +Start by obtaining all of the mempool tx IDs: + +````mdx-code-block +```json +chia rpc full_node get_all_mempool_tx_ids +``` +```` + +Response: + +````mdx-code-block +```json +{ + "success": true, + "tx_ids": [ + "0x2e2888b99a21d5a52f94fa11ef19ee1a7cf1498512345b89119aa201f9ae49f1", + "0xd52609e605464bc7eedbfde28d2e75d2b9a5ba06865de283ad4e6c456b8ed86e", + "0x68b38b9d3607e258242dd18f940d6802a9f07fbd65123b220d89bdda2530c87f", + "0xbc8924954ca39f0b8d78ad4fd42f9da4670c3cb9c93cd4c94ab5c8cd18c7fd1a", + "0xfe7304fdd91512cf2e0346014e5df53656441e02b1e34f5c06d4413a4cdf5355", + "0x7e8092bb18a76b067e7eb6429ca4e95ec4b0f616d08d0d2a936bdc4d2c9e37b3", + "0x6f28332ea48d049d4129631da57abae4a12cbdcd5754e516217b0d226ea7b365", + "0x413a72ebc3c8b2d33ebfbc9b8c9e59a92cf3d465005717aab19d7bd495300178", + "0xa6f42465a2b03effbf397a81766ab723ff901392d50ca91dcbec32fe25f864db", + "0x709a278da6d8093b0063c90061c18eb74eb8d49677166dc239455eeaaa9d4315" + ] +} +``` +```` + +Next, obtain a mempool item for one of the IDs: + +````mdx-code-block +```json +chia rpc full_node get_mempool_item_by_tx_id '{"tx_id": "0x709a278da6d8093b0063c90061c18eb74eb8d49677166dc239455eeaaa9d4315"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "mempool_item": { + "additions": [ + { + "amount": 1, + "parent_coin_info": "0x5d9e0afbb54f1aa70e3a9394b45019b14ce4385dbe2ad765d4eafcc4766d5312", + "puzzle_hash": "0x4a5ba4c44a890036378f2f3a0bd1288e4d1fb1a66f4ba7336556cadf6b949ea0" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0x5d9e0afbb54f1aa70e3a9394b45019b14ce4385dbe2ad765d4eafcc4766d5312", + "puzzle_hash": "0x2f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57" + } + ], + "cost": 41414384, + "fee": 0, + "npc_result": { + "conds": { + "agg_sig_unsafe": [], + "before_height_absolute": null, + "before_seconds_absolute": null, + "cost": 41414384, + "height_absolute": 0, + "reserve_fee": 0, + "seconds_absolute": 0, + "spends": [ + { + "agg_sig_me": [], + "before_height_relative": null, + "before_seconds_relative": null, + "coin_id": "0x5d9e0afbb54f1aa70e3a9394b45019b14ce4385dbe2ad765d4eafcc4766d5312", + "create_coin": [ + [ + "0x4a5ba4c44a890036378f2f3a0bd1288e4d1fb1a66f4ba7336556cadf6b949ea0", + 1, + null + ], + [ + "0x2f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57", + 1750000000000, + null + ] + ], + "flags": 1, + "height_relative": null, + "puzzle_hash": "0x4a5ba4c44a890036378f2f3a0bd1288e4d1fb1a66f4ba7336556cadf6b949ea0", + "seconds_relative": 0 + }, + { + "agg_sig_me": [], + "before_height_relative": null, + "before_seconds_relative": null, + "coin_id": "0xddb3a7807de91a8b1f0a1eb8aab5e6baf5e924b6827421677738c3c73b9bba20", + "create_coin": [], + "flags": 1, + "height_relative": null, + "puzzle_hash": "0x19e2f23b7994d7f019c365047df40a1c514ad520060fc38a31e83f8a2ac7b831", + "seconds_relative": 0 + } + ] + }, + "cost": 41414384, + "error": null + }, + "removals": [ + { + "amount": 1, + "parent_coin_info": "0xd7dd2fdb3dabe44589d1d3f08efd2970b135883bc93a6acb58065a7d1b7a62db", + "puzzle_hash": "0x4a5ba4c44a890036378f2f3a0bd1288e4d1fb1a66f4ba7336556cadf6b949ea0" + }, + { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000330552", + "puzzle_hash": "0x19e2f23b7994d7f019c365047df40a1c514ad520060fc38a31e83f8a2ac7b831" + } + ], + "spend_bundle": { + "aggregated_signature": "0xc00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "coin_spends": [ + { + "coin": { + "amount": 1, + "parent_coin_info": "0xd7dd2fdb3dabe44589d1d3f08efd2970b135883bc93a6acb58065a7d1b7a62db", + "puzzle_hash": "0x4a5ba4c44a890036378f2f3a0bd1288e4d1fb1a66f4ba7336556cadf6b949ea0" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fffff010180ffff01ff02ff36ffff04ff02ffff04ff05ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff0bff80808080ffff04ff2fffff04ff0bffff04ff5fff808080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4602ff3304ffff0101ff02ffff02ffff03ff05ffff01ff02ff5cffff04ff02ffff04ff0dffff04ffff0bff2cffff0bff24ff3880ffff0bff2cffff0bff2cffff0bff24ff3480ff0980ffff0bff2cff0bffff0bff24ff8080808080ff8080808080ffff010b80ff0180ff02ffff03ff0bffff01ff02ff32ffff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ffff02ff2affff04ff02ffff04ffff02ffff03ffff09ff23ff2880ffff0181b3ff8080ff0180ff80808080ff80808080808080ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffffff0bffff0bff17ffff02ff3affff04ff02ffff04ff09ffff04ff2fffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ff5f80ff0bff81bf80ff02ffff03ffff20ffff22ff4fff178080ffff01ff02ff7effff04ff02ffff04ff6fffff04ffff04ffff02ffff03ff4fffff01ff04ff23ffff04ffff02ff3affff04ff02ffff04ff09ffff04ff53ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff81b3ff80808080ffff011380ff0180ffff02ff7cffff04ff02ffff04ff05ffff04ff1bffff04ffff21ff4fff1780ff80808080808080ff8080808080ffff01ff088080ff0180ffff04ffff09ffff18ff05ffff010180ffff010180ffff09ff05ffff01818f8080ff0bff2cffff0bff24ff3080ffff0bff2cffff0bff2cffff0bff24ff3480ff0580ffff0bff2cffff02ff5cffff04ff02ffff04ff07ffff04ffff0bff24ff2480ff8080808080ffff0bff24ff8080808080ffffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff26ffff04ff02ffff04ff09ff80808080ffff02ff26ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ff5effff04ff02ffff04ff05ffff04ff0bffff04ffff02ff3affff04ff02ffff04ff09ffff04ff17ffff04ffff02ff26ffff04ff02ffff04ff05ff80808080ff808080808080ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfff80808080808080808080ffff04ffff04ff20ffff04ff17ff808080ffff02ff7cffff04ff02ffff04ff05ffff04ffff02ff82017fffff04ffff04ffff04ff17ff2f80ffff04ffff04ff5fff81bf80ffff04ff0bff05808080ff8202ff8080ffff01ff80808080808080ffff02ff2effff04ff02ffff04ff05ffff04ff0bffff04ffff02ffff03ff3bffff01ff02ff22ffff04ff02ffff04ff05ffff04ff17ffff04ff13ffff04ff2bffff04ff5bffff04ff5fff808080808080808080ffff01ff02ffff03ffff09ff15ffff0bff13ff1dff2b8080ffff01ff0bff15ff17ff5f80ffff01ff088080ff018080ff0180ffff04ff17ffff04ff2fffff04ff5fffff04ff81bfffff04ff82017fff8080808080808080808080ff02ffff03ff05ffff011bffff010b80ff0180ff018080ffff04ffff01ffa024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffa04819a540b5e7e4d60c4e769d7d92e3a13e5b415307b1bfe7720c6765915fdc62a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff8202ffffff01ff02ff16ffff04ff02ffff04ff05ffff04ff8204bfffff04ff8206bfffff04ff82017fffff04ffff0bffff19ff2fffff18ffff019100ffffffffffffffffffffffffffffffffff8202ff8080ff0bff82017f80ff8080808080808080ffff01ff04ffff04ff08ffff04ff17ffff04ffff02ff1effff04ff02ffff04ff82017fff80808080ff80808080ffff04ffff04ff1cffff04ff5fffff04ff8206bfff80808080ff80808080ff0180ffff04ffff01ffff32ff3d33ff3effff04ffff04ff1cffff04ff0bffff04ff17ff80808080ffff04ffff04ff1cffff04ff05ffff04ff2fff80808080ffff04ffff04ff0affff04ff5fff808080ffff04ffff04ff14ffff04ffff0bff5fffff012480ff808080ff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a02f2c9ba1b2315d413a92b5f034fa03282ccba1767fd9ae7b14d942b969ed5d57ffff04ffff01a019e2f23b7994d7f019c365047df40a1c514ad520060fc38a31e83f8a2ac7b831ffff04ffff01b0823a5af392a43d9c5e89d72aa43986bc0126f1f04ffdd6484f2c1f31622cb6ef13f0737bc6da33aed1e630848b85dcafffff04ffff01a0ccd5bb71183532bff220ba46c268991a00000000000000000000000000000000ffff04ffff01a0cc9728481857e8105b55902128b6c1c94e8e6be34e3423d6a3168fdd722e874eff01808080808080ff01808080", + "solution": "0xffffa04502047116ae95837c7cb738577b7259bca6cdb1d522d984ff0d4101777f7793ffa07cb500cb108dbfb7e8024cf8a54615fc21bc8591b97946fa5d52015420bae4e0ff0180ff01ffff8601977420dc00ff833305528080" + }, + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000330552", + "puzzle_hash": "0x19e2f23b7994d7f019c365047df40a1c514ad520060fc38a31e83f8a2ac7b831" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff82017fffff01ff04ffff04ff38ffff04ffff0bffff02ff2effff04ff02ffff04ff05ffff04ff81bfffff04ffff02ff3effff04ff02ffff04ffff04ff05ffff04ff0bff178080ff80808080ff808080808080ff82017f80ff808080ffff04ffff04ff3cffff01ff248080ffff04ffff04ff28ffff04ff82017fff808080ff80808080ffff01ff04ffff04ff24ffff04ff2fff808080ffff04ffff04ff2cffff04ff5fffff04ff81bfff80808080ffff04ffff04ff10ffff04ff81bfff808080ff8080808080ff0180ffff04ffff01ffffff49ff463fffff5002ff333cffff04ff0101ffff02ff02ffff03ff05ffff01ff02ff36ffff04ff02ffff04ff0dffff04ffff0bff26ffff0bff2aff1280ffff0bff26ffff0bff26ffff0bff2aff3a80ff0980ffff0bff26ff0bffff0bff2aff8080808080ff8080808080ffff010b80ff0180ffff0bff26ffff0bff2aff3480ffff0bff26ffff0bff26ffff0bff2aff3a80ff0580ffff0bff26ffff02ff36ffff04ff02ffff04ff07ffff04ffff0bff2aff2a80ff8080808080ffff0bff2aff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01a024e044101e57b3d8c908b8a38ad57848afd29d3eecc439dba45f4412df4954fdffff04ffff01a04819a540b5e7e4d60c4e769d7d92e3a13e5b415307b1bfe7720c6765915fdc62ffff04ffff01a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff0183093a80ffff04ffff01a02998ceb02bed2cddfc692c37737a95ac83af4bacf7897ac6c0170c93bcd021bbff01808080808080", + "solution": "0xffa07cb500cb108dbfb7e8024cf8a54615fc21bc8591b97946fa5d52015420bae4e0ffa0ddb3a7807de91a8b1f0a1eb8aab5e6baf5e924b6827421677738c3c73b9bba2080" + } + ] + }, + "spend_bundle_name": "0x709a278da6d8093b0063c90061c18eb74eb8d49677166dc239455eeaaa9d4315" + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_mempool_items_by_coin_name` + +Functionality: Gets the mempool's details for a specific coin + +Usage: chia rpc full_node [OPTIONS] get_mempool_items_by_coin_name [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :----------------------------- | :----- | :------- | :------------------------------------------------------------------------------------------------- | +| coin_name | STRING | True | The ID of the coin to retreive. Must be in the mempool in order to return a result | + +
+Example + +````mdx-code-block +```json + chia rpc full_node get_mempool_items_by_coin_name '{"coin_name": "0xfceac40f1cfe41cc7f0be5f80b9dc1be5d28475a6e8cb3d89a78f0baaee7065a"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "mempool_items": [ + { + "additions": [ + { + "amount": 1000000000000, + "parent_coin_info": "0xfceac40f1cfe41cc7f0be5f80b9dc1be5d28475a6e8cb3d89a78f0baaee7065a", + "puzzle_hash": "0xa46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b" + } + ], + "cost": 8624562, + "fee": 0, + "npc_result": { + "conds": { + "addition_amount": 1000000000000, + "agg_sig_unsafe": [], + "before_height_absolute": null, + "before_seconds_absolute": null, + "cost": 8624562, + "height_absolute": 0, + "removal_amount": 1000000000000, + "reserve_fee": 0, + "seconds_absolute": 0, + "spends": [ + { + "agg_sig_amount": [], + "agg_sig_me": [ + [ + "0xb93e1797a30d4a5c643d2c39aacc6c4ef92f0add94f119a912f7b2f0476e754af692a794e65c6db156f15006e659b0d0", + "0x5e5ee042c003d60b8da7c0145c636e892e2d2d0e065be80a51e0e6e00e2b6e70" + ] + ], + "agg_sig_parent": [], + "agg_sig_parent_amount": [], + "agg_sig_parent_puzzle": [], + "agg_sig_puzzle": [], + "agg_sig_puzzle_amount": [], + "before_height_relative": null, + "before_seconds_relative": null, + "birth_height": null, + "birth_seconds": null, + "coin_amount": 1000000000000, + "coin_id": "0xfceac40f1cfe41cc7f0be5f80b9dc1be5d28475a6e8cb3d89a78f0baaee7065a", + "create_coin": [ + [ + "0xa46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b", + 1000000000000, + null + ] + ], + "flags": 0, + "height_relative": null, + "parent_id": "0x03cb7935c3aeff31e380165ec108966807a03686e7ab731e29b9264a789006be", + "puzzle_hash": "0xa46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b", + "seconds_relative": null + } + ] + }, + "cost": 8624562, + "error": null + }, + "removals": [ + { + "amount": 1000000000000, + "parent_coin_info": "0x03cb7935c3aeff31e380165ec108966807a03686e7ab731e29b9264a789006be", + "puzzle_hash": "0xa46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b" + } + ], + "spend_bundle": { + "aggregated_signature": "0xa51148b289ba9a2e1ab7b3a88dc2d1c34f94a3cbdd36301db10a05a30a5609f37e807e798ca10ac4fe3cb5d9ee5dcd7b14a0b2bdaa9a039b4affc0ff5abf6ab078230a716d30c0f2f822c2075f0d74a72b474faa2aee443a4e575eb5f279651e", + "coin_spends": [ + { + "coin": { + "amount": 1000000000000, + "parent_coin_info": "0x03cb7935c3aeff31e380165ec108966807a03686e7ab731e29b9264a789006be", + "puzzle_hash": "0xa46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504b" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0b93e1797a30d4a5c643d2c39aacc6c4ef92f0add94f119a912f7b2f0476e754af692a794e65c6db156f15006e659b0d0ff018080", + "solution": "0xff80ffff01ffff33ffa0a46f580ea101dbf07afcbb2c11d66f34938bf24612954398d3908281ea5a504bff8600e8d4a5100080ffff3cffa07cc6853091834c31c6c00b7f4c522c942e727b3f3bdc410d8eb83205e38d16108080ff8080" + } + ] + }, + "spend_bundle_name": "0xe59b8b4219e0d54ddc3c0a21625697208bb119f8f737fba5df40cf111ac6db2c" + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_network_info` + +Functionality: Retrieves information about the current network + +Usage: chia rpc full_node [OPTIONS] get_network_info [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_network_info +``` +```` + +Response: + +````mdx-code-block +```json +{ + "network_name": "mainnet", + "network_prefix": "xch", + "success": true +} +``` +```` + +
+ +--- + +### `get_network_space` + +Functionality: Retrieves an estimate of the netspace, which is the total plotted space of all farmers, in bytes + +Usage: chia rpc full_node [OPTIONS] get_network_space [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :------------------------------------------------------------------------------------- | :--------- | :------- | :-------------------- | +| older_block_header_hash | HEX STRING | True | The start header hash | +| newer_block_header_hash | HEX STRING | True | The end header hash | + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_network_space '{"older_block_header_hash": "023cbcdc3cb97e5ddeb6fe40a6a28b303255bb821090b237d00dd77c9dfefb7a", "newer_block_header_hash": "6c26e4a79b437de1272942a7c4c78e1af3a71741f1244b14320279c7084cf3c8"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "space": 26915196432975761408, + "success": true +} +``` +```` + +The result is the average network space (in bytes) from the blocks starting with `older_block_header_hash` and ending with `newer_block_header_hash`. + +To calculate this value in EiB, divide it by 2^60. The result is 23.345 EiB in this example. + +
+ +--- + +### `get_puzzle_and_solution` + +Functionality: Retrieves a coin's spend record by its coin ID, sometimes referred to as "coin name". +Coin IDs can be calculated by hashing the coin: `sha256(parent_coin + puzzle_hash + amount)` + +Usage: chia rpc full_node [OPTIONS] get_puzzle_and_solution [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :--------------------------- | :--------- | :------- | :--------------------------------- | +| coin_id | HEX STRING | True | Coin ID of the coin to look up | +| height | INTEGER | True | Height at which the coin was spent | + +:::note + +The puzzle and solution are provided in CLVM format. +The coin must have been spent in order to fetch this information. +By definition, coins that are unspent do not have their original puzzle or solution stored on-chain. + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_puzzle_and_solution '{"coin_id": "0x985221340d70b38cee51d35fdbb64c333e15e7c27133e962d39237672985fdc9", "height": 3343255}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "coin_solution": { + "coin": { + "amount": 1, + "parent_coin_info": "0x6666c08616cb83af7107a57f080169c4c17dc4cc32c1d326328e5b1c1b506fea", + "puzzle_hash": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9" + }, + "puzzle_reveal": "0xff02ffff01ff04ffff04ff04ffff04ff05ffff04ff0bff80808080ffff04ffff04ff0affff04ffff02ff0effff04ff02ffff04ffff04ff05ffff04ff0bffff04ff17ff80808080ff80808080ff808080ff808080ffff04ffff01ff33ff3cff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff0effff04ff02ffff04ff09ff80808080ffff02ff0effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080", + "solution": "0xffa0cd4a0d9da9564494bb3e8e0c9679380d9e1a659f0944e8478315ecadc82dc5daff01ff8080" + }, + "success": true +} +``` +```` + +
+ +--- + +### `get_recent_signage_point_or_eos` + +Functionality: Retrieves a recent signage point or end of slot + +Usage: chia rpc full_node [OPTIONS] get_recent_signage_point_or_eos [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :---------------------------------- | :--------- | :------- | :---------------------------------------------------------------------------------------------------------------- | +| sp_hash | HEX STRING | True\* | The hash of the output for a signage point (if it's in the middle of a sub slot) | +| challenge_hash | HEX STRING | True\* | The challenge_hash for the subslot (if it's an end of sub slot challenge) | + +:::note + +\*Either `sp_hash` or `challenge_hash` are required to be included in the query + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_recent_signage_point_or_eos '{"challenge_hash": "0xc97facdb04807e595f46f76961febeea245c044d35152e4397e5c4878d5bce37"}' +``` +```` + +Response: + +````mdx-code-block +```json +{ + "eos": { + "challenge_chain": { + "challenge_chain_end_of_slot_vdf": { + "challenge": "0xc948e91995a270a48e8b6cc8db3a944ed74aef4d03be0f325205fba903445c70", + "number_of_iterations": 146800640, + "output": { + "data": "0x020027a053f82874cfe8dc53c08d2ce5e791cab0391279898099ad8abfe21412725b45eb35dc60eb98592c14c7b5d8a305e2c3f77b3f63ee0fe7d04a9708d4e361283bf7d747a58edb778b5cb52608ed4fa42e8def51a0a6aba9d985aecd05710b410100" + } + }, + "infused_challenge_chain_sub_slot_hash": "0x7a26f76f0f6eda6d8033fd93306d10c01eb71a69fc0471a322feb855e8c67257", + "new_difficulty": null, + "new_sub_slot_iters": null, + "subepoch_summary_hash": null + }, + "infused_challenge_chain": { + "infused_challenge_chain_end_of_slot_vdf": { + "challenge": "0xac729280140c4d5bc4793c485042397e09c86683559142d0156a1d89cd5c691e", + "number_of_iterations": 131095906, + "output": { + "data": "0x0200dc26e19b58d71a48623ea87b174cff7ead8b9d6e7bfff842f3bc0fd7694627943e82fb8c7df88676f9b780083bf9430efb95f261fd6ec48ae133141888801a071f0302dea9f1d021609c6864f3323c8d264fd99131f56a4f43e0fda35a16ba060706" + } + } + }, + "proofs": { + "challenge_chain_slot_proof": { + "normalized_to_identity": false, + "witness": "0x0300385a0b580b0ba47b04264b29a21543a4797f2a40d7a631c2b7ed2029906d0df45c66f115fa8ee8ea8a08d59a2f590c82ca37ce73a9b5e90400878dc7aa253c2fc776b7494ddc41d3d4eee78323ed8d5cc5b6d63752bf562b464254952ab019480100000000000004dee098971949dde52ecba255fe335978a979f17d20431981ce52b7ab1bc2fbeed0c8650100e02163d8a06f70d49002a9941b629b9e1fcb5e442961e0cdb934a85105fa34c5f4426de2658ce1dc6d7aed7019607cac7e57fde35b7201ec0b4184b9f024d91a7fc011a6a415b1cc679f7f6a00a95575c5f4f29b891b0d7c3d4fc9e9d066f126030100000000000e9d04a47b9e85b9450b1c526b4b017d9526ba5275115f27688f9777bd9bfa386f2f1a3902003c4ac70e6197f97b61cc8a010e7e0f8761c861ef92e06e699d36557735836f36f1c996e453339be55b942fee499787d180f1aa255ed53e353ca0c981ba2b596095172319067aeeff0f7c63557c2bfb63a3b5c38c1423ad46dcbdf3a9e68fff3e0100", + "witness_type": 2 + }, + "infused_challenge_chain_slot_proof": { + "normalized_to_identity": false, + "witness": "0x0100de23f1da9d925937af12f7d0ab6ca0d9e6d61db06a3e160c776bae38f84903543745ef0c56200af5fde336cee3773fe4a48570c333edf8e2245a02c476cf7f3d5317d04993f41baa68d493f0014f6b6c98d8faba91943f11fd1dcdf253b57a030100000000000004dee0c98772ed5956507ae19690fb7ca410582c58c370995e3b8509cdac90eefe628a83000016233c3f1075c33ad60b06a0d6bb9c2003b5c2f9ec97c1e0f79f32689a9245831b23b647e57c08c5b9a5bc14fa2206f605fbb0cc5fbd26465eb48c8dba2aaf10676c18b87b197fb4567640357dbdda113ab6441f06b78bde8ccd98a41d4d7b1d010000000000000e9d04ca9d9e8e96a9770a769bf4403da504df78dd33c5ff9ed1990525f9f5e4e0f9445b0000fd514bf86e5d96e3be474abb40daf8b5efa76cde333bb840bd69caf751e0863497f94267addae1e39346e21f43534d1e6052f3d9b278ba931bdbb047ba7efb5a51fcaa91ad1f79f7dbec6805da9a32375492c91bd22615e086516131f134643f0100", + "witness_type": 2 + }, + "reward_chain_slot_proof": { + "normalized_to_identity": false, + "witness": "0x0200e631425613dd99e65b0aa7f2d98c6033b69c597796e1b86f9ec380e609c47492d5bdafd50c5101a49946a888f1633dcf412c1dc3276cc14c7764007282e14f4ccb0fd0eabc80e45c5dad7e559bd64149714a49b9363b132b7116fdb66b669a250100000000000004dee0f3272ed4d79f6ba93c75bc953deb52b53955842faecb96a1dec32686c4bf14017103008ba373b8593f8e964b6f5582b46e4de4b7dae5db66c49e92b50288533a3c5909f341ea917ad3a4a832e71b28af685876e6bbb2176f737a8c1c33066e00078f4350f4ed25d638a9c0b7962388207cf43a64f1bf08174e0458be1bf8e28b201222010000000000000e9d049285451259f6f4ef346a92daf3b1f1979215e5a7f85393c8197a44d5038929f3c1000034cf575bc6ebaa5ff8ed3d318820e44ce070eea4f617dafca320d43044f9b1ec3a2a9c531662a9a2abaf37b15db2ea7283f0fee1772bd40a2fbcc03114fdca5fbb77b5c7668bd1eef4e52f4daf56422a68986d0a9a38453fa6a4b33b8333d9390100", + "witness_type": 2 + } + }, + "reward_chain": { + "challenge_chain_sub_slot_hash": "0xc97facdb04807e595f46f76961febeea245c044d35152e4397e5c4878d5bce37", + "deficit": 16, + "end_of_slot_vdf": { + "challenge": "0x9775fc146e7df73e6052cd132707d17f0f9691024b33be59fac47681b5483a4a", + "number_of_iterations": 1436581, + "output": { + "data": "0x01004837f41f0f4bbddae80e964719de25c68429324a057c37cd49baea6934d82d7f6b83fbe4610ef018301302c5d39315c597234f55b12bdf627024bbe0761d070e81e5d45f40b974f9c3c883ae074d648449fdb501aeb3e8e478dabfe927ce2f0c0603" + } + }, + "infused_challenge_chain_sub_slot_hash": "0x7a26f76f0f6eda6d8033fd93306d10c01eb71a69fc0471a322feb855e8c67257" + } + }, + "reverted": false, + "success": true, + "time_received": 1678155344.7621934 +} +``` +```` + +
+ +--- + +### `get_routes` + +Functionality: Show all RPC endpoints. This endpoint is lightweight and can be used as a health check. However, a better option may be `healthz` (below) + +Usage: chia rpc full_node [OPTIONS] get_routes [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_routes +``` +```` + +Response: + +````mdx-code-block +```json +{ + "routes": [ + "/get_blockchain_state", + "/get_block", + "/get_blocks", + "/get_block_count_metrics", + "/get_block_record_by_height", + "/get_block_record", + "/get_block_records", + "/get_block_spends", + "/get_block_spends_with_conditions", + "/get_unfinished_block_headers", + "/get_network_space", + "/get_additions_and_removals", + "/get_initial_freeze_period", + "/get_network_info", + "/get_recent_signage_point_or_eos", + "/get_coin_records_by_puzzle_hash", + "/get_coin_records_by_puzzle_hashes", + "/get_coin_record_by_name", + "/get_coin_records_by_names", + "/get_coin_records_by_parent_ids", + "/get_coin_records_by_hint", + "/push_tx", + "/get_puzzle_and_solution", + "/get_all_mempool_tx_ids", + "/get_all_mempool_items", + "/get_mempool_item_by_tx_id", + "/get_mempool_items_by_coin_name", + "/get_fee_estimate", + "/get_connections", + "/open_connection", + "/close_connection", + "/stop_node", + "/get_routes", + "/healthz" + ], + "success": true +} +``` +```` + +
+ +--- + +### `get_unfinished_block_headers` + +Functionality: Retrieves recent unfinished header blocks + +Usage: chia rpc full_node [OPTIONS] get_unfinished_block_headers [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +:::note + +These blocks might get finished and confirmed soon. +The height and header hash is unknown, because some of these blocks might not get confirmed, which will affect the +blocks after it. + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node get_unfinished_block_headers +``` +```` + +Response: + +````mdx-code-block +```json +{ + "headers": [ + { + "challenge_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0300ca3027dc768d1894470dbecde30493ab040b86d51cfd2d969be08af17030f222087aae7b32809afa1aa956f57ae932905c2ae91dc20eaa2eb8ecb59b65966a191b46dc28d10b06968bb0354f0070f9ab95f630131bdf7eafcc2c038ddb9790190401000000000001be7c88dfe3104cb9ff068568d46b4b3edbfe1b4effb2e3cb9d5bf42e57808a59b3f231020098ceddbffa9f0b27b2879228bfcbbdaab4f50608673886d36e81c9b3af1683e509ff92adcc79c4313898e654a6ab0ea27c3725d8b96e29a151c6e414afb51f5c7178c34f482d367ca4b1f7ec7459464171aeabe59cb8dd74fee98f24702c9d2c01000000000000053c3ceeb304ad81ae251a2fc3d8988da7c084c39dfac2fec36ec3e9412f49240a46a709030096053c4468ca4622bb9dfce38ee52f7c2791857d6486b2bf4f7f753c0b880b4870a0618ed071d472971936558406638d68fbb226284e26c26640077347fe963af79be18d9afdc60a50fdfd9a834103ac558b745a953951d98a49f6801cced1450100", + "witness_type": 2 + }, + "finished_sub_slots": [], + "foliage": { + "foliage_block_data": { + "extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9", + "farmer_reward_puzzle_hash": "0x907491ca39c35bc1f9a6eda33f7c0f97a9f583975088dad7216f1edd79f522ae", + "pool_signature": "0xa286f7bcbce546f4ec55f9a37a67adf504d92e1afa711d488568c09914ad227e1fb4b1315c24150a2b9f8af8c437ec12068b5a6bc3eedb25827061971e99b305024d6fe7fa7c61d8180cd92f267f8fcc2bc5c40cded03d194b6d3ff8cb9966b9", + "pool_target": { + "max_height": 0, + "puzzle_hash": "0x907491ca39c35bc1f9a6eda33f7c0f97a9f583975088dad7216f1edd79f522ae" + }, + "unfinished_reward_block_hash": "0x84eeb3aad2cb25d554da983bbd58cfdec83f082da6d06a3eb9943cfb89578989" + }, + "foliage_block_data_signature": "0xaab8ff2a66014493d01021bfffc99d772140f5b891548165c8cccef9164be7a37aa1dba638e3983e11546921bc1c8ebb16e150c379c7fca3591f22dbc21e8925ca57e239f3210ac0b8f8da37a3622969db2082f3ffba5781d8b12a08d55a6e33", + "foliage_transaction_block_hash": "0x43e5fc07f3351fa4e5eba530ef6c9e784c9bf37d3bfd61a11714beef4a4ec91a", + "foliage_transaction_block_signature": "0x8a04372cef9f2f2fc7dee74f6739fb8d45fcb70d7831378fb64080b9f83f24b3385cc5d8d284595c03033837b722a6bd0d1db4df76f589f399e4e12c565bf85d85a44a6965c22cf84bf715f25861c22bd6c99b6f6c6a120efd9609d67ceb255e", + "prev_block_hash": "0x13e5ef5813e2ad994184c953d7e7dff766428ea5ed0580c2149dabc66747b57a", + "reward_block_hash": "0x84eeb3aad2cb25d554da983bbd58cfdec83f082da6d06a3eb9943cfb89578989" + }, + "foliage_transaction_block": { + "additions_root": "0x62b9bf13134a0e3bab44dc4550d75686f3f24c3fbb9a20b3eb58022ed0a99a74", + "filter_hash": "0xe43808ab7534cd3ed1645e476e00ca2ac4926b1dc09ab96d0cf744507fd41b02", + "prev_transaction_block_hash": "0x2c534d6a32e7a53a3fc33baa8ab05504d7721d3395911e36144bd9b0589d4f25", + "removals_root": "0x0000000000000000000000000000000000000000000000000000000000000000", + "timestamp": 1678076245, + "transactions_info_hash": "0x22d97282cf7d02d4fbbba37bf58fd1fdcd4fe24f5be95a30f0dc92828c1ba1c0" + }, + "reward_chain_block": { + "challenge_chain_sp_signature": "0x8cc561c0cc79e73b44506954c4ebd85e7667bdbe13f253e96fdd1cb895b612f266510429f6b82858a60c36e59e333a770456e8c096d8de5372d51884edf11803b6e426d04db5b8b6ba5743ed8033b7b11dc57d9a8fee211c4389771d61fdcc90", + "challenge_chain_sp_vdf": { + "challenge": "0x7e7fc1d74f8d710b7a17017504bfd7e9863973cb60bbfefe1b6ce5588a1d4735", + "number_of_iterations": 36700160, + "output": { + "data": "0x0100290f45aa544d64443cd183b5b0bb0eddc112fb4fcbba73159b1b04b6476203f8417d10f36868adb6cda400b0b9b625d57b07ba6bb258d9f0b825601b414a6942c3b69e32858409996ec8619160623d56db115aaa5661816f4453dfc6e434082a0100" + } + }, + "pos_ss_cc_challenge_hash": "0x7e7fc1d74f8d710b7a17017504bfd7e9863973cb60bbfefe1b6ce5588a1d4735", + "proof_of_space": { + "challenge": "0x685cda6bb6c77da65df3f93da220ff55581985b3472a6d06fe146c833fee4626", + "plot_public_key": "0x86cc6327dbe8d0c8646689f789ab4560e2b10bd5892131eed2b020ce409fb8fb76b873a439f7040dc9609179bde5d152", + "pool_contract_puzzle_hash": null, + "pool_public_key": "0xb87e833fd714490b72eb7a390cfc1605f79b60d3f18d909e094f25001535842bc48be9db46fa465fbf9db26a3d7f4b6d", + "proof": "0xa223d3fda3c718d0b1be65f33a901f7b8c5434ef7e46fd7321ad66572b1d87d52853ed6fb3137453536e85b09ad02bf52f7278780d349993e1081c1c2437c1a249ea5f30dbf13a6204ba0655634f9428312a0402df2ecf16de6f4187fc556e74040d8b0729cc7fc135133f6cc75b402353e412e9a13a906816c73dfea94c82fdf659bfe856bca057693210d1ac950a384038dd4c69186444509491a4efaea6c998e87990e75ec77b6575df62d1819558203886f769de990b674fbf770fd6437a59804a889e49a1c8cdd9e8085e515e7dbbe436ae077e6238df26e5565c8e6645e1cc3b560e1c7d87411a58f0ac1562db3ee19b79c14df0403a7aad9b8609a7cf", + "size": 32 + }, + "reward_chain_sp_signature": "0xb75969dd2cd7d701aba2719b512c0675b598d632e0175473d2644a48eb9e385a113f205653e2d5a133a831067e3026dc036c37974efbda351e1a6eac95d4b81fe4fdde71ea68d44454208bc72f1428cbb56ccfcd64b5a1120d34c125cfd83e46", + "reward_chain_sp_vdf": { + "challenge": "0x772c50de1700f58b608ff8fc77a4310aa475c9c9c98a932a446845370a52b500", + "number_of_iterations": 514688, + "output": { + "data": "0x03007ca6f95897feb5e6a9fb9f6538437f089eee4de540bfde9a2b0ba831fbd21aef9ab4b46c172224e39f420aac719a2cc6a36cd5ae78f79b1057523e3167ecb512350f2e6348175eefac8709a68463ca7ae4067bae81e9814fc57f9b348d935c2b0100" + } + }, + "signage_point_index": 16, + "total_iters": 13800993484113 + }, + "reward_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0300fa111380d3200d60319b5942b6d64db9b4566687af69151ff753883d16cb1b6114950a2f8866196befd3a29b86122f9f4bcc1edccdf24e832f633589ac3bed4d09627f07b52fa80f6a58208a9315c2084cca9806b056bdf0a06b860a48633c5c0100000000000001be7ce234ebd932c7440269ce060daae5d28653d4752bd9116daefb35dac0e3ec8d668700001f471a60c7d939dabee596ab5deed888a602acdeec14a0979bf9c0ae63cb9408cb73e0655641daa87faa7ef2b5947d3500222dd072fe92fde5e122f7d2975d0c49edb3821a550e481e744e0590b0962e12de68aeed4d1f1b690ef32cc75b6b1501000000000000053c3c897461dbcbafa7d3867fab45ec4dce8278fe6cf0973970cda2e947e0d0da99f7410000d40006147d7e566ec7bbe4b7d413fcc8b763507c2b26f6155cb30cbd51737c495affc981e4c22710fd3316e76ca46b2a41bde411d17c0cd76dbe53a15823953a3daa4ef3652133cf11718f8453ea12f846251d249b61cee3787b48885594d23b0100", + "witness_type": 2 + }, + "transactions_filter": "0x" + }, + { + "challenge_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0300ca3027dc768d1894470dbecde30493ab040b86d51cfd2d969be08af17030f222087aae7b32809afa1aa956f57ae932905c2ae91dc20eaa2eb8ecb59b65966a191b46dc28d10b06968bb0354f0070f9ab95f630131bdf7eafcc2c038ddb9790190401000000000001be7c88dfe3104cb9ff068568d46b4b3edbfe1b4effb2e3cb9d5bf42e57808a59b3f231020098ceddbffa9f0b27b2879228bfcbbdaab4f50608673886d36e81c9b3af1683e509ff92adcc79c4313898e654a6ab0ea27c3725d8b96e29a151c6e414afb51f5c7178c34f482d367ca4b1f7ec7459464171aeabe59cb8dd74fee98f24702c9d2c01000000000000053c3ceeb304ad81ae251a2fc3d8988da7c084c39dfac2fec36ec3e9412f49240a46a709030096053c4468ca4622bb9dfce38ee52f7c2791857d6486b2bf4f7f753c0b880b4870a0618ed071d472971936558406638d68fbb226284e26c26640077347fe963af79be18d9afdc60a50fdfd9a834103ac558b745a953951d98a49f6801cced1450100", + "witness_type": 2 + }, + "finished_sub_slots": [], + "foliage": { + "foliage_block_data": { + "extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9", + "farmer_reward_puzzle_hash": "0xecbbcb78f5e7ab31e90c4c8252122da7ca7c74bfb75fdf1be96a3c9686adfa88", + "pool_signature": null, + "pool_target": { + "max_height": 0, + "puzzle_hash": "0xbb88a2972f7eca1429bfaab93a4b40489eca9ce93dd9f457fb73d6977b52a54f" + }, + "unfinished_reward_block_hash": "0x7470e73998d09e5013ee4716755bb1c9c2149c4a20bbc08ab018162db84309c9" + }, + "foliage_block_data_signature": "0x84c681c118c30d61fdb0138e4b8733934c6449eae06fcb138046ecfb7e00a7fa7b8a91e5a616a6ac6e2790bc607fad600ad7e02f20fc71258fec7febc413057fe5e000d7015680a11045ad663d39e966eab0d2dcc779a7b65cb02e4940f342f7", + "foliage_transaction_block_hash": "0x6207a41a0a8d8b7424e19b6c86986923cde7141111ffd7649bef80a1008cc1d2", + "foliage_transaction_block_signature": "0x99efa3bc08e637a1bb9cf76fd65f34b4605a604ef5bfb35730e9c4fc6823b98db84d811e4e4be98a2ea0e389619fe915167127552a18f755200a8eeac7013cbde11b3b627965d716807a5cfad6a72d8003cacc061ea887f3116b24271458d5d5", + "prev_block_hash": "0x13e5ef5813e2ad994184c953d7e7dff766428ea5ed0580c2149dabc66747b57a", + "reward_block_hash": "0x7470e73998d09e5013ee4716755bb1c9c2149c4a20bbc08ab018162db84309c9" + }, + "foliage_transaction_block": { + "additions_root": "0x5f5ef826f1463990296e049903b1f93f67dec29dcf9f4bdf0eea05aa16b21ad3", + "filter_hash": "0x8e4730e59db228c6528bd2134b70cbe9610d4593b9c02edb97819661ed9f7d20", + "prev_transaction_block_hash": "0x2c534d6a32e7a53a3fc33baa8ab05504d7721d3395911e36144bd9b0589d4f25", + "removals_root": "0x1e5bfb0949fe7b292fd4cf54dd9f6ed48ff57187e765259b3ce3f324d27c5ecc", + "timestamp": 1678076244, + "transactions_info_hash": "0x92c0158e5c018e05435623b250df4e35351fe3da1a2dd053eae3c42251749086" + }, + "reward_chain_block": { + "challenge_chain_sp_signature": "0x8013eb086cec8e807b1234f1db5f8e1c1f2dacc69ffb1ca895339855d9b3bf1ea2226eeb04a784846c31941fba74269907b5b72ad639b2f159d2fa6dafc4e92566cea6d25e812417d784780096b7e4e3a934388cf689d28f3b1a4f159ace7ba5", + "challenge_chain_sp_vdf": { + "challenge": "0x7e7fc1d74f8d710b7a17017504bfd7e9863973cb60bbfefe1b6ce5588a1d4735", + "number_of_iterations": 36700160, + "output": { + "data": "0x0100290f45aa544d64443cd183b5b0bb0eddc112fb4fcbba73159b1b04b6476203f8417d10f36868adb6cda400b0b9b625d57b07ba6bb258d9f0b825601b414a6942c3b69e32858409996ec8619160623d56db115aaa5661816f4453dfc6e434082a0100" + } + }, + "pos_ss_cc_challenge_hash": "0x7e7fc1d74f8d710b7a17017504bfd7e9863973cb60bbfefe1b6ce5588a1d4735", + "proof_of_space": { + "challenge": "0x81838f2a5f615d3db9e2359d18c7c508cfcf5e4f5c7c17f3414ecd2dacb0380d", + "plot_public_key": "0x8cb625dca79cc77cff1f56ba63e94e51a706246dc8f48602161f0d804a2d1a68eb47e69272df5bd35a9bc1f68f12c241", + "pool_contract_puzzle_hash": "0xbb88a2972f7eca1429bfaab93a4b40489eca9ce93dd9f457fb73d6977b52a54f", + "pool_public_key": null, + "proof": "0x4ba33da1552300576e90838cb582e9c0265b863a12bbc3cc5a5d14dcd945fe56df49a76f3fcf19ebd06d7720c11a65c110a5ae785f269b7420360aa2cb16178c72b0121126322a12808632a91b90619589d15eb29057cda878b4c7a5a89c6871099a74788f21cbcf219ffa8b5b046d8d93c653bf11f86c71baf421e401867c37ec4ae1c0fb746bc9145102fda711793e05ed7f5cddccc2a7047195f16467a8214295d8ae0ecf76d5467e5149a3e9319cebee07f1c0fb4be6096032ca1c08bf60ee9b8ad87fdafb707e24809dab3c505566ce22cdab252c6bae5872673a6f7963a2edfdc2c7e8f05e4847580e3b4fdc72321bedcf778edbd85ed0884b2dff67d0", + "size": 32 + }, + "reward_chain_sp_signature": "0x94f11bca7b3d0f3bc4a3a1edd8a051567cc8698796c03c20491b969771ad159e600e06a3b51260113d5f6effd61aeb7e0a5980efe24e943caa73342f3b9475f66f0e6a742f355cd0d1486785d6db401e29ac3c068fffb1d7134690d13f417e84", + "reward_chain_sp_vdf": { + "challenge": "0x772c50de1700f58b608ff8fc77a4310aa475c9c9c98a932a446845370a52b500", + "number_of_iterations": 514688, + "output": { + "data": "0x03007ca6f95897feb5e6a9fb9f6538437f089eee4de540bfde9a2b0ba831fbd21aef9ab4b46c172224e39f420aac719a2cc6a36cd5ae78f79b1057523e3167ecb512350f2e6348175eefac8709a68463ca7ae4067bae81e9814fc57f9b348d935c2b0100" + } + }, + "signage_point_index": 16, + "total_iters": 13800993149685 + }, + "reward_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0300fa111380d3200d60319b5942b6d64db9b4566687af69151ff753883d16cb1b6114950a2f8866196befd3a29b86122f9f4bcc1edccdf24e832f633589ac3bed4d09627f07b52fa80f6a58208a9315c2084cca9806b056bdf0a06b860a48633c5c0100000000000001be7ce234ebd932c7440269ce060daae5d28653d4752bd9116daefb35dac0e3ec8d668700001f471a60c7d939dabee596ab5deed888a602acdeec14a0979bf9c0ae63cb9408cb73e0655641daa87faa7ef2b5947d3500222dd072fe92fde5e122f7d2975d0c49edb3821a550e481e744e0590b0962e12de68aeed4d1f1b690ef32cc75b6b1501000000000000053c3c897461dbcbafa7d3867fab45ec4dce8278fe6cf0973970cda2e947e0d0da99f7410000d40006147d7e566ec7bbe4b7d413fcc8b763507c2b26f6155cb30cbd51737c495affc981e4c22710fd3316e76ca46b2a41bde411d17c0cd76dbe53a15823953a3daa4ef3652133cf11718f8453ea12f846251d249b61cee3787b48885594d23b0100", + "witness_type": 2 + }, + "transactions_filter": "0x" + }, + { + "challenge_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0100a7812fd45b95894c5725ed3ed14a1be3247e76ea02365b36d0366cfab82ab98a0169da19a1ae4d425d5819b94798e02af9bcfde5098ef55d208e535b11906940f14f6ac42055c0247f3081e1d340408e81860d46b4dd06aec426a13b5a60a449010000000000000985e4d5e0fb85326a31a4897e8845538bd20e9bedaf8c46c9f8e1833d1e86f295f90857030023af6b075910a3e486b3687930244425f2826dc7550909aeeca846c202452816745413bc9ab8ca2fda478fe269b5726a8b39a1b2f002045f4faee6edf10bcd1eb15e4800b4ba94bfa894bdc9c1f5d3ef5bdccc74aca46d9020e6730c8a77ed01010000000000001c9148c8bc9b8bf67dc6c09185e9bb17fcda7c2ddf2983d1d72e4898bc50553964297f1b010024cf9f31b4532269cd6a452c14fa0e1e991b2980e833e28d59c78d2a756c0a5678dce61b8b71cf3f3f8cd37611f37960163e99b9e95312419936600de4a22301e172887cb1c82bea369eb423bcf05577a4ab140332f82a3e21d5712c1fa0d2013725", + "witness_type": 2 + }, + "finished_sub_slots": [], + "foliage": { + "foliage_block_data": { + "extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9", + "farmer_reward_puzzle_hash": "0x4bc6435b409bcbabe53870dae0f03755f6aabb4594c5915ec983acf12a5d1fba", + "pool_signature": "0xa7f170e0c32587d1db9f6f68f28e3c5793b4a86c6affae174cbd4bda9ec096a796d244ccf95e62171d7839d30bfeac09003ccad7f90283b4b653b68cb1a347c70a678d42162c49ffb188ef2d45d21fbffb3c8853b0ce2ee6f67f7e14d9486936", + "pool_target": { + "max_height": 0, + "puzzle_hash": "0x4bc6435b409bcbabe53870dae0f03755f6aabb4594c5915ec983acf12a5d1fba" + }, + "unfinished_reward_block_hash": "0xab6691f6f5c13ff0a4680f3e902efcc82641df64523657d4f132c4a70db21b99" + }, + "foliage_block_data_signature": "0x90cd090312b65b26e794413d15edab3616f01e48110f72fc875e2493b0aad86f99216562237d1cf62ea84861ec14f7860a7a968260f6946c041cc628728542c8a3ef627823e2c176cacc47e84119fcb50ed6f2356908d23cf5f308dc9a9a17ab", + "foliage_transaction_block_hash": "0x2ca39854f6a32a9c50896b8b165927705adf212f848ca16a28f6d283d55f7954", + "foliage_transaction_block_signature": "0xa66e5916a26cd78bb084e7cd7d59c36ebd39a01fa8aeb790d09cacaeb1c22d8daba4f5c6a9877ac275aa2794482c194c0b5b23128fb65e834da8c61d4b808963913d239d791cb04f67c4a0cdb9003a8d7571dc2ff143ec3a954e73fa69d939ba", + "prev_block_hash": "0x13e5ef5813e2ad994184c953d7e7dff766428ea5ed0580c2149dabc66747b57a", + "reward_block_hash": "0xab6691f6f5c13ff0a4680f3e902efcc82641df64523657d4f132c4a70db21b99" + }, + "foliage_transaction_block": { + "additions_root": "0x1611eb80ea5476b4283e41fe8b33c88a2d85b26145dac97c30885a381801b971", + "filter_hash": "0xd8445e477a9814015dc994eabf973350ddeb67c37ecfae98163bbc301f69149d", + "prev_transaction_block_hash": "0x2c534d6a32e7a53a3fc33baa8ab05504d7721d3395911e36144bd9b0589d4f25", + "removals_root": "0x5b47cf171919444e1aaa2497b97908be5a4bec1084f193f14a634c93c4cfbe63", + "timestamp": 1678076253, + "transactions_info_hash": "0x71bd40a43bb9a1e867e7825ef90cd9c1105d808cc5a7083758003b8c1142bf92" + }, + "reward_chain_block": { + "challenge_chain_sp_signature": "0xb2c9730cee6362f1c400ed898d6bc5a2cf0018da986ab20cc87cb2393cd04e5bd1dbf5d3052a9f5e093c35806accc876027c7e6bd498eeced2710f000a7865e74f960811688658df0eccd63243b2a83fa63859dc2168bda7be629507ec5c764f", + "challenge_chain_sp_vdf": { + "challenge": "0x7e7fc1d74f8d710b7a17017504bfd7e9863973cb60bbfefe1b6ce5588a1d4735", + "number_of_iterations": 38993920, + "output": { + "data": "0x01002e9a936483f31a9fe6ee941e90bb9a44ba75c8ed1d77d82b6767a7eeef696ae8f0a2b03b550faf941162df0b79b6bc48119967fa4d469944ca077cf88faca13e97999bc713a26d98929d63637b2be38f0be774640db4c17ed98757045880312a0100" + } + }, + "pos_ss_cc_challenge_hash": "0x7e7fc1d74f8d710b7a17017504bfd7e9863973cb60bbfefe1b6ce5588a1d4735", + "proof_of_space": { + "challenge": "0x18a067db011ecb6ae11daa0d9f1a5a74a2cdf45eaa1af837f92ee2bc6caaa579", + "plot_public_key": "0x87d8b49520dd5262720596bf47b51bb1161eeeeefd7c5d6c8023eec52470450093c0bfe8fc7c5152f5d8f6674c61f220", + "pool_contract_puzzle_hash": null, + "pool_public_key": "0x9479b5cc0b3116a3154c6cb8da72c3cb3a28b08b6fad1f5ed42bbd72c9592053a94f2f96f2355e68649be57a0ee7301b", + "proof": "0x0e43984d2720911a5c0846ce6b2483e9d6e1c196244d0c765aa4091c6786e95d4821df1ccaf6a804c0d2c3c4e573f15e13350ef5ad978957ce2fa3e3030cc1a31b3eee5131754f7e09e75882b0d1c62e5e2c1e46b02d210d6a3fbd6a4088bb6bd00e51bbd6c7f74a54e28ebcadd8b974658f5e3eead70238eae296cc6230404990a935135c4f4db77bcc2466b80205bad92c833e3726b216557d8a8996524f8e5b119945662021ddc370a63c0b31ec01e1a32fce138a9546fc7106dad08bfdf6f82bc4007950ef6f760e98356735dbd0f4404b82e889ded8accee174811b7c6d1410131b674fb336fc5efc6bc7a78f57e081c205793367ca7eb9540c374d6287", + "size": 32 + }, + "reward_chain_sp_signature": "0x811c7ff4a490e56b0446efaaf6615331332e5336a4236c7f60b47b9f7a4fba451f91e66fff82ad2410e69ae58cd7e64b02fa034c80f7eafbad465bea970c5c0c12b33e93122c60ee9f1c89b2142d83c5379f1194c8101bce8c974b96e4a3f78f", + "reward_chain_sp_vdf": { + "challenge": "0x772c50de1700f58b608ff8fc77a4310aa475c9c9c98a932a446845370a52b500", + "number_of_iterations": 2808448, + "output": { + "data": "0x01000d28a0e12edad31164692421c351320086e66088909ba45f183fa16644a9abd28bb9c68efd6841cfc8f4d74b5f6eeae71ff99c9cbba60da8b5ee5533a5038b519c41f66d0d9854020f66c62790faf884d657052e7ec5b1f92da182ec0b8e53380100" + } + }, + "signage_point_index": 17, + "total_iters": 13800994274820 + }, + "reward_chain_sp_proof": { + "normalized_to_identity": false, + "witness": "0x0300028e7d5ecd547ec041a458448e56a40d8bd7ebe773ada675602a31524acb33b9c74bc52bb94bf3eb6247201fa773ac63f9a95ea873e85e3239667a4baaf003092301b6cbf2205735bd3aeabc7693adee8daad44d608f43cbfc7f1a34bc604b00090400000000000985e49d20d91582f149c4fe527889310c42992553050b41aa193636cec7b9ca21f9d9e301002cee3b9ef8cba41005299d061e858d94bad90655db31d77298e70357d69bd6183f722c1b851d9c2436d0633014bb6bc4b6e30ddf07849177c2d85da33e95a90f473a481bf7d6c59ffd913ef1d815b13df00c9e59d6caf42e859188b5feb8df11040100000000001c9148b58c79b63cd8a492328bf845b0708a6f531bdc7e626b8081bace46de851c2369070200985c4704482f4e56a260196b875a160d56fc2767f61dca677c3f256e15945c8cfbe9422d4dcaae3bddeadcaea585b85433537291f732e138db4bb07cd94f8918e3b6725f891e08eded7c3a93fe0b6a46993e626cc2514ab06b85182dab6bfa340100", + "witness_type": 2 + }, + "transactions_filter": "0x" + } + ], + "success": true +} +``` +```` + +
+ +--- + +### `healthz` + +Functionality: Verifies that the RPC service is running + +Usage: chia rpc full_node [OPTIONS] healthz [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: None + +:::note + +This RPC returns `200` if successful. It is lightweight and can be queried often in intervals. + +::: + +
+Example + +````mdx-code-block +```json +chia rpc full_node healthz +``` +```` + +Response: + +````mdx-code-block +```json +{ + "success": true +} +``` +```` + +
+ +--- + +### `push_tx` + +Functionality: Pushes a transaction / spend bundle to the mempool and blockchain. +Returns whether the spend bundle was successfully included into the mempool + +Usage: chia rpc full_node [OPTIONS] push_tx [REQUEST] + +Options: + +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +| -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | +| -h | --help | None | False | Show a help message and exit | + +Request Parameters: + +| Flag | Type | Required | Description | +| :-------------------------------- | :--- | :------- | :------------------------------ | +| spend_bundle | JSON | True | Spend bundle to submit, in JSON | + +
+Example + +````mdx-code-block +```json +chia rpc full_node push_tx +'{ + "spend_bundle": { + "aggregated_signature": "0xa5e5ea1f5ae2335a72fe0a7ed7ca39e8f142e2e1f6e37a348482290e88eb9cea2d973acf6145e34d0afeee7ba22f99850641e21a549b2c092bb49aa393acd938825bccca9413c1a268ba44367bc8433cd0fc0eb82e87bebe23817aa695bdb566", + "coin_spends": [ + { + "coin": { + "amount": 1750000000000, + "parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082", + "puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10" + }, + "puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080", + "solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080" + } + ] + } +}' +``` +```` + +Response: + +````mdx-code-block +```json +{ "status": "SUCCESS", "success": true } +``` +```` + +
+ +:::note Note 1 + +`SUCCESS` does not guarantee that the transaction will get confirmed. A transaction may be dropped from the mempool and not +included if the fee is too low. A transaction may also be combined with other transactions to form different spend +bundles, so looking up the bundle by ID does not guarantee finding the original transaction. The transaction can be +resubmitted with a higher fee, as long as the coins spent in the new transaction are a superset of the coins spent in +the old one. + +::: + +:::note Note 2 + +To check whether a transaction has been confirmed, use [get_coin_record_by_name](#get_coin_record_by_name) with +each coin id that should be created by this spend bundle. + +The error status can be one of: + +- **SUCCESS**: if the transaction was successfully added to the mempool +- **PENDING**: if the transaction cannot be included yes due to timelocks or conflicts +- **FAILED**: transaction was not added to the mempool, and was dropped + +::: + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md index 789b71f567..67a4040f3e 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md @@ -38,14 +38,14 @@ Usage: chia rpc harvester [OPTIONS] add_plot_directory [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :--- | :------- | :------------------------------------ | +|:------- |:---- |:-------- |:------------------------------------- | | dirname | TEXT | True | The full path of the directory to add | :::note @@ -90,14 +90,14 @@ Usage: chia rpc harvester [OPTIONS] delete_plot [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :--- | :------- | :---------------------------------- | +|:-------- |:---- |:-------- |:----------------------------------- | | filename | TEXT | True | The file name of the plot to delete | :::note @@ -134,7 +134,7 @@ Usage: chia rpc harvester [OPTIONS] get_plots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -204,7 +204,7 @@ Usage: chia rpc harvester [OPTIONS] get_plot_directories [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -242,7 +242,7 @@ Usage: chia rpc harvester [OPTIONS] get_routes [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -290,7 +290,7 @@ Usage: chia rpc harvester [OPTIONS] refresh_plots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -330,14 +330,14 @@ Usage: chia rpc harvester [OPTIONS] remove_plot_directory [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :--- | :------- | :--------------------------------------- | +|:------- |:---- |:-------- |:---------------------------------------- | | dirname | TEXT | True | The full path of the directory to remove | :::note diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md index 0c03ed27cc..28f9e6fba0 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md @@ -37,16 +37,16 @@ Usage: chia rpc wallet [OPTIONS] nft_add_uri [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------ | :--------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:---------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the DID wallet to transfer | -| nft_coin_id | HEX STRING | True | The coin ID of the NFT on which to add a URI | +| nft_coin_id | HEX STRING | True | The coin ID of the NFT on which to add a URI | | key | STRING | True | Must be either `u` (data URI), `mu` (metadata URI), or `lu` (license URI) | | uri | STRING | True | The URI to add | | fee | NUMBER | False | The one-time blockchain fee to be used upon adding a URI | @@ -156,14 +156,14 @@ Usage: chia rpc wallet [OPTIONS] nft_calculate_royalties [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Sub-Parameter | Required | Description | -| :-------------- | :------------------------------------------------------------------------------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:--------------- |:------------------------------------------------------------------------------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | royalty_assets | Each royalty asset requires three sub-parameters, listed on the following lines | False | A list of NFTs for which to calculate royalties. If this parameter is not included, then nothing will be returned | | | asset | True | The asset ID of the NFT to be traded. This is only used for display in the response; a bogus value may be used | | | royalty_address | True | The address where the royalties will be sent. A bogus value may be used | @@ -259,14 +259,14 @@ Usage: chia rpc wallet [OPTIONS] nft_count_nfts [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :--------------------------------------------------------------------------- | +|:--------- |:------ |:-------- |:---------------------------------------------------------------------------- | | wallet_id | NUMBER | False | The ID of the wallet in which to count NFTs [Default: null (count all NFTs)] |
@@ -339,14 +339,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_by_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----- | :----- | :------- | :-------------------- | +|:------ |:------ |:-------- |:--------------------- | | did_id | NUMBER | True | The DID ID to examine |
@@ -378,14 +378,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_info [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :--------------------------------------------------- | +|:--------- |:------ |:-------- |:---------------------------------------------------- | | coin_id | NUMBER | True | The coin ID of the NFT about which to retrieve info | | wallet_id | NUMBER | False | The Wallet ID of the NFT from which to retrieve info | @@ -459,6 +459,8 @@ Response: ```json { + "nft_info": { + "chain_info": "((117 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.gif\") (104 . 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\") (27765 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . { "nft_info": { "chain_info": "((117 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.gif\") (104 . 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\") (27765 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . 0x2267456bd2cef8ebc2f22a42947b068bc3b138284a587feda2edfe07a3577f50))", "data_hash": "0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b", @@ -507,14 +509,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_nfts [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :----- | :------- | :----------------------------------------------------------------- | +|:----------- |:------ |:-------- |:------------------------------------------------------------------ | | wallet_id | NUMBER | True | The Wallet ID from which to retrieve the NFTs | | start_index | NUMBER | False | The NFT index at which to start retrieving the NFTs [Default: `0`] | | num | NUMBER | False | The maximum number of NFTs to retrieve [Default: `0`] | @@ -573,7 +575,7 @@ Usage: chia rpc wallet [OPTIONS] nft_get_wallets_with_dids Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -614,14 +616,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_wallet_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------- | +|:--------- |:------ |:-------- |:------------------------------ | | wallet_id | NUMBER | True | The Wallet ID of an NFT wallet |
@@ -653,30 +655,30 @@ Usage: chia rpc wallet [OPTIONS] nft_mint_bulk [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :--------------------- | :----------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the NFT wallet to use for bulk minting | -| metadata_list | STRING ARRAY | True | A list of dicts containing the metadata for each NFT to be minted | -| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | -| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | -| target_list | STRING ARRAY | False | A list of wallet addresses where the NFTs will be sent upon minting | +| Flag | Type | Required | Description | +|:------------------------ |:------------ |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the NFT wallet to use for bulk minting | +| metadata_list | STRING ARRAY | True | A list of dicts containing the metadata for each NFT to be minted | +| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | +| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | +| target_list | STRING ARRAY | False | A list of wallet addresses where the NFTs will be sent upon minting | | mint_number_start | NUMBER | False | The starting point for mint number used in intermediate launcher puzzle. Default: 1 | -| mint_total | NUMBER | False | The total number of NFTs in the collection. Note that this is not necessarily reflective of the number of NFTs this command will create in the spend bundle, which is derived based on the `metadata_list`. For example, you could set `mint_total` to `1000` and pass only 10 dicts in `metadata_list`. | +| mint_total | NUMBER | False | The total number of NFTs in the collection. Note that this is not necessarily reflective of the number of NFTs this command will create in the spend bundle, which is derived based on the `metadata_list`. For example, you could set `mint_total` to `1000` and pass only 10 dicts in `metadata_list`. | | xch_coin_list | STRING ARRAY | False | A list of coins to be used for funding the minting spend. These coins can be created in the future | | xch_change_target | HEX STRING | False | For use with bulk minting, so we can specify the puzzle hash that the change from the funding transaction goes to. | -| new_innerpuzhash | HEX STRING | False | The new inner puzzle hash for the DID once it is spent. For bulk minting we generally don't provide this as the default behaviour is to re-use the existing inner puzzle hash | +| new_innerpuzhash | HEX STRING | False | The new inner puzzle hash for the DID once it is spent. For bulk minting we generally don't provide this as the default behaviour is to re-use the existing inner puzzle hash | | new_p2_puzhash | HEX STRING | False | The new p2 puzzle hash for the DID once it is spent. For bulk minting we generally don't provide this as the default behaviour is to re-use the existing inner puzzle hash | | did_coin_dict | DICTIONARY | False | The did coin to use for minting. Required for bulk minting when the DID coin will be created in the future | | did_lineage_parent_hex | HEX STRING | False | The parent coin to use for the lineage proof in the DID spend. Needed for bulk minting when the coin will be created in the future | | mint_from_did | BOOLEAN | False | Boolean to determine whether to mint from a DID. Default: false | -| fee | NUMBER | False | A blockchain fee to be deducted with each mint | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| fee | NUMBER | False | A blockchain fee to be deducted with each mint | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -783,29 +785,29 @@ Usage: chia rpc wallet [OPTIONS] nft_mint_nft [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :----------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | -| wallet_id | NUMBER | True | The Wallet ID in which to mint an NFT | -| uris | STRING ARRAY | True | A list of URIs to mark the location(s) of the NFT | -| hash | HEX STRING | True | The hash of the NFT's data. This should use sha256 for proper verification against the URI list | -| did_id | STRING | False | Optionally specify the DID to be associated with this NFT | -| meta_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's metadata | -| meta_hash | HEX STRING | False | The hash of the NFT's metadata | -| license_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's license | -| license_hash | HEX STRING | False | The hash of the NFT's license | -| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | -| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | -| target_address | STRING | False | The wallet address of the initial owner of the NFT. This may be the same as the royalty address | | -| edition_number | NUMBER | False | If this NFT has multiple editions (multiple identical copies of an NFT), then this parameter indicates the edition number of this NFT. | -| edition_total | NUMBER | False | If this NFT has multiple editions, then this parameter indicates the total number of editions of this NFT. This parameter should be used if and only if the `edition_number` parameter was also used | -| fee | NUMBER | False | The one-time blockchain fee to be used upon minting the NFT | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| Flag | Type | Required | Description | +|:------------------ |:------------ |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| wallet_id | NUMBER | True | The Wallet ID in which to mint an NFT | +| uris | STRING ARRAY | True | A list of URIs to mark the location(s) of the NFT | +| hash | HEX STRING | True | The hash of the NFT's data. This should use sha256 for proper verification against the URI list | +| did_id | STRING | False | Optionally specify the DID to be associated with this NFT | +| meta_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's metadata | +| meta_hash | HEX STRING | False | The hash of the NFT's metadata | +| license_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's license | +| license_hash | HEX STRING | False | The hash of the NFT's license | +| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | +| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | +| target_address | STRING | False | The wallet address of the initial owner of the NFT. This may be the same as the royalty address | | +| edition_number | NUMBER | False | If this NFT has multiple editions (multiple identical copies of an NFT), then this parameter indicates the edition number of this NFT. | +| edition_total | NUMBER | False | If this NFT has multiple editions, then this parameter indicates the total number of editions of this NFT. This parameter should be used if and only if the `edition_number` parameter was also used | +| fee | NUMBER | False | The one-time blockchain fee to be used upon minting the NFT | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example 1 - Mint an NFT without using a DID @@ -983,18 +985,18 @@ Usage: chia rpc wallet [OPTIONS] nft_set_did_bulk [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------ | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +|:--------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | nft_coin_list | STRING ARRAY | True | A list of coin IDs corresponding to the NFTs, along with the current wallet_ids. Syntax: `[{"nft_coin_id": COIN_ID/NFT_ID, "wallet_id": WALLET_ID}, ...]` | -| did_id | STRING | False | The ID of the DID to which to transfer the NFTs. [Default: no DID (reset the NFTs' DIDs)] | -| fee | NUMBER | False | An optional blockchain fee | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| did_id | STRING | False | The ID of the DID to which to transfer the NFTs. [Default: no DID (reset the NFTs' DIDs)] | +| fee | NUMBER | False | An optional blockchain fee | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -1086,16 +1088,16 @@ Usage: chia rpc wallet [OPTIONS] nft_set_nft_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID that holds the NFT on which to set the DID | -| nft_coin_id | NUMBER | True | The coin ID of the NFT on which to set the DID | +| nft_coin_id | NUMBER | True | The coin ID of the NFT on which to set the DID | | did_id | NUMBER | False | Optionally specify the DID to be associated with this NFT. If this parameter is not specified, the DID will be Unassigned | | fee | NUMBER | False | The one-time blockchain fee to be used upon adding a URI | | reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | @@ -1212,6 +1214,9 @@ In the response, `owner_did` is now set: ```json { + "nft_list": [ + { + "chain_info": "((117 \"https://images.pexels.com/photos/1509582/pexels-photo-1509582.jpeg\") (104 . 0x0ebedcd2cda065c75132218f745cecc3a1c131927f70b192b3fe6bbebaf437c4) (28021 \"https://pastebin.com/raw/BHZc1suk\" \"https://pastebin.com/raw/bnzGwjmB\") (27765 \"https://raw.githubusercontent.com/Chia-Network/chia-blockchain/main/LICENSE\") (29550 . 1) (29556 . 1) (28008 . 0x07cb3cc71732d1979abd357af86475e1e35f6c2b41ed2387b309e4b486a89a51) (27752 . { "nft_list": [ { "chain_info": "((117 \"https://images.pexels.com/photos/1509582/pexels-photo-1509582.jpeg\") (104 . 0x0ebedcd2cda065c75132218f745cecc3a1c131927f70b192b3fe6bbebaf437c4) (28021 \"https://pastebin.com/raw/BHZc1suk\" \"https://pastebin.com/raw/bnzGwjmB\") (27765 \"https://raw.githubusercontent.com/Chia-Network/chia-blockchain/main/LICENSE\") (29550 . 1) (29556 . 1) (28008 . 0x07cb3cc71732d1979abd357af86475e1e35f6c2b41ed2387b309e4b486a89a51) (27752 . 0x30a358857da6b49f57cfe819c1ca43bfe007f528eb784df5da5cb64577e0ffc6))", @@ -1234,10 +1239,10 @@ In the response, `owner_did` is now set: ], "mint_height": 1688221, "minter_did": "0xb08c01ace955ce180ce2e0b332b4c8d98d46469078e5191351f025d9cf9117f3", - "nft_coin_id": "0xe4497290bdfc82ddbc01828f8fa2c9c0c9413f20debe3baeef59d39b6f5c24de", + "nft_coin_id": "0x46a6638642eeea83432d7fe419882ed5aeb2ed82e2490cea40279a5ffe7ac1ff", "off_chain_metadata": null, - "owner_did": "0xb08c01ace955ce180ce2e0b332b4c8d98d46469078e5191351f025d9cf9117f3", + "owner_did": null, "p2_address": "0x8b4c2d1a6c7ac0914875db5a19e23fe7608c67f43ffe242e5519ae54737336e6", "pending_transaction": false, @@ -1248,7 +1253,7 @@ In the response, `owner_did` is now set: } ], "success": true, - "wallet_id": 5 + "wallet_id": 4 } ``` @@ -1265,14 +1270,14 @@ Usage: chia rpc wallet [OPTIONS] nft_set_nft_status [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------- | :------ | :------- | :-------------------------------------------------- | +|:-------------- |:------- |:-------- |:--------------------------------------------------- | | wallet_id | NUMBER | True | The ID of an NFT wallet | | coin_id | NUMBER | True | The coin_id of the NFT on which to set the status | | in_transaction | BOOLEAN | True | A boolean to set the transaction status for the NFT | @@ -1305,18 +1310,18 @@ Usage: chia rpc wallet [OPTIONS] nft_transfer_bulk [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| nft_coin_list | STRING ARRAY | True | A list of coin IDs corresponding to the NFTs, along with the current wallet_ids. Syntax: `[{"nft_coin_id": COIN_ID/NFT_ID, "wallet_id": WALLET_ID}, ...]` | -| target_address | STRING | True | The address to which to transfer the NFTs | -| fee | NUMBER | False | An optional blockchain fee | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| Flag | Type | Required | Description | +|:--------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| nft_coin_list | STRING ARRAY | True | A list of coin IDs corresponding to the NFTs, along with the current wallet_ids. Syntax: `[{"nft_coin_id": COIN_ID/NFT_ID, "wallet_id": WALLET_ID}, ...]` | +| target_address | STRING | True | The address to which to transfer the NFTs | +| fee | NUMBER | False | An optional blockchain fee | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -1399,17 +1404,17 @@ Usage: chia rpc wallet [OPTIONS] nft_transfer_nft [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------- | :--------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:-------------- |:---------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the NFT to transfer | | target_address | STRING | True | The address to transfer the NFT to. For NFT0 this must be an XCH address. For NFT1 this could also be a DID address | -| nft_coin_id | HEX STRING | True | The coin ID of the NFT to transfer | +| nft_coin_id | HEX STRING | True | The coin ID of the NFT to transfer | | fee | NUMBER | False | The one-time blockchain fee to be used upon transferring the NFT | | reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md index ca05921b90..0c40fcdd11 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md @@ -37,17 +37,17 @@ Usage: chia rpc wallet [OPTIONS] cancel_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------- | -| trade_id | STRING | True | The `trade_id` of the Offer to cancel. Can be retrieved from an Offer file by calling `cdv inspect spendbundles ` | -| fee | NUMBER | False | An optional fee (in mojos) to include with the cancellation [Default: `0`] | -| secure | BOOLEAN | False | If `true`, then "cancel on blockchain," ie spend the coins being offered. If `false`, then cancel locally [Default: `true`] | +| Flag | Type | Required | Description | +|:-------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| trade_id | STRING | True | The `trade_id` of the Offer to cancel. The `trade_id` of the Offer to cancel. Can be retrieved from an Offer file by calling `cdv inspect spendbundles ` | +| fee | NUMBER | False | An optional fee (in mojos) to include with the cancellation [Default: `0`] | +| secure | BOOLEAN | False | If `true`, then "cancel on blockchain," ie spend the coins being offered. If `false`, then cancel locally [Default: `true`] | :::note @@ -83,14 +83,14 @@ Usage: chia rpc wallet [OPTIONS] cancel_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------- | +|:---------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------- | | secure | BOOLEAN | True | If `true`, then "cancel on blockchain," ie spend the coins being offered. If `false`, then cancel locally | | fee | NUMBER | False | An optional fee (in mojos) to include with the cancellation [Default: `0`] | | batch_size | NUMBER | False | The number of Offers to cancel in one batch [Default: `5`] | @@ -125,14 +125,14 @@ Usage: chia rpc wallet [OPTIONS] check_offer_validity [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :----- | :------- | :-------------------------------- | +|:----- |:------ |:-------- |:--------------------------------- | | offer | STRING | True | The text of the Offer to validate | :::note @@ -181,29 +181,29 @@ Usage: chia rpc wallet [OPTIONS] create_offer_for_ids [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :-------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------- | -| offer | OBJECT | True | A dictionary `[str, int]` of the Offer to create (see the examples below for specifics) | -| fee | NUMBER | False | An optional fee (in mojos) to include with the Offer [Default: `0`] | -| validate_only | BOOLEAN | False | Set to `true` to verify the validity of a potential Offer, rather than actually creating an Offer [Default: `false`] | -| driver_dict | OBJECT | False | A dictionary `[str, Any]` containing metadata of the asset being requested, for example an NFT's on-chain metadata | +| Flag | Type | Required | Description | +|:----------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------- | +| offer | OBJECT | True | A dictionary `[str, int]` of the Offer to create (see the examples below for specifics) | +| fee | NUMBER | False | An optional fee (in mojos) to include with the Offer [Default: `0`] | +| validate_only | BOOLEAN | False | Set to `true` to verify the validity of a potential Offer, rather than actually creating an Offer [Default: `false`] | +| driver_dict | OBJECT | False | A dictionary `[str, Any]` containing metadata of the asset being requested, for example an NFT's on-chain metadata | | min_coin_amount | NUMBER | False | The minimum coin size to be included in the Offer [Default: `0`] | | max_coin_amount | NUMBER | False | The maximum coin size to be included in the Offer [Default: `0`] | -| solver | | False | Default: None | -| min_height | NUMBER | False | The minimum block height that must be reached before this Offer becomes valid [Default: `null` (not used)] | -| min_time | NUMBER | False | The minimum UNIX timestamp that must be reached before this Offer becomes valid [Default: `null` (not used)] | -| max_height | NUMBER | False | The maximum block height where this Offer is still considered valid, aka the expiry height [Default: `null` (not used)] | -| max_time | NUMBER | False | The maximum UNIX timestamp where this Offer is stil considered valid, aka the expiry timestamp [Default: `null` (not used)] | +| solver | | False | Default: None | +| min_height | NUMBER | False | The minimum block height that must be reached before this Offer becomes valid [Default: `null` (not used)] | +| min_time | NUMBER | False | The minimum UNIX timestamp that must be reached before this Offer becomes valid [Default: `null` (not used)] | +| max_height | NUMBER | False | The maximum block height where this Offer is still considered valid, aka the expiry height [Default: `null` (not used)] | +| max_time | NUMBER | False | The maximum UNIX timestamp where this Offer is stil considered valid, aka the expiry timestamp [Default: `null` (not used)] | :::note -Although relative time lock flags are included in Offer files, the RPC API does not yet support them. The unsupported flags include: +Although relative time lock flags are included in Offer files, the RPC API does not yet support them. The unsupported flags include: The unsupported flags include: - `max_blocks_after_created` - `max_secs_after_created` @@ -212,7 +212,7 @@ Although relative time lock flags are included in Offer files, the RPC API does In addition, of the four absolute time lock flags, the reference wallet will only recognize `max_time`. -The other three **(**`min_height`, `min_time`, and `max_height`**)** are each enforced on the blockchain, but the reference wallet will not currently understand that the time locks need to be applied until it submits the Offer spendbundle to the mempool. For this reason, if you use the reference wallet to accept an Offer that uses any of these three flags, the transaction will be initiated, but will fail. Your log file will contain `ASSERT_SECONDS_ABSOLUTE_FAILED` in this case, but the GUI will continue to show the pending transaction as if it were still valid. +The other three **(**`min_height`, `min_time`, and `max_height`**)** are each enforced on the blockchain, but the reference wallet will not currently understand that the time locks need to be applied until it submits the Offer spendbundle to the mempool. For this reason, if you use the reference wallet to accept an Offer that uses any of these three flags, the transaction will be initiated, but will fail. Your log file will contain `ASSERT_SECONDS_ABSOLUTE_FAILED` in this case, but the GUI will continue to show the pending transaction as if it were still valid. For this reason, if you use the reference wallet to accept an Offer that uses any of these three flags, the transaction will be initiated, but will fail. Your log file will contain `ASSERT_SECONDS_ABSOLUTE_FAILED` in this case, but the GUI will continue to show the pending transaction as if it were still valid. ::: @@ -229,6 +229,9 @@ Response: ```json { + "nft_list": [ + { + "chain_info": "((117 \"https://bafkreifouyunkfshyhywp27uxx62bicxmarr263kohlyshg6s5yphv5acq.ipfs.nftstorage.link\") (104 . 0xaea628d51647c1f167ebf4bdfda0a05760231d7b6a71d7891cde9770f3d7a014) (28021 \"https://bafkreibspamgjmtkisxjqocjqpb3qjo4tqmjacrhe6d7jmddgdny5kenuu.ipfs.nftstorage.link\") (27765 \"https://bafkreibd6dchfc56by7fntdoe2viwdnbfbhowals4ivipugkzq6btx7koq.ipfs.nftstorage.link/\") (29550 . 1) (29556 . 1) (28008 . 0x32781864b26a44ae98384983c3b825dc9c18900a272787f4b06330db8ea88da5) (27752 . { "nft_list": [ { "chain_info": "((117 \"https://bafkreifouyunkfshyhywp27uxx62bicxmarr263kohlyshg6s5yphv5acq.ipfs.nftstorage.link\") (104 . 0xaea628d51647c1f167ebf4bdfda0a05760231d7b6a71d7891cde9770f3d7a014) (28021 \"https://bafkreibspamgjmtkisxjqocjqpb3qjo4tqmjacrhe6d7jmddgdny5kenuu.ipfs.nftstorage.link\") (27765 \"https://bafkreibd6dchfc56by7fntdoe2viwdnbfbhowals4ivipugkzq6btx7koq.ipfs.nftstorage.link/\") (29550 . 1) (29556 . 1) (28008 . 0x32781864b26a44ae98384983c3b825dc9c18900a272787f4b06330db8ea88da5) (27752 . 0x23f0c4728bbe0e3e56cc6e26aa8b0da1284eeb0172e22a87d0cacc3c19dfea74))", @@ -267,7 +270,7 @@ Response: } ``` -Note the value of `launcher_id`, which in this case is `0x93c7f48778b5758254bf8dcf6ce50bf203841e30735979d3a075b49342276d0d`. This will be needed momentarily. +Note the value of `launcher_id`, which in this case is `0x93c7f48778b5758254bf8dcf6ce50bf203841e30735979d3a075b49342276d0d`. This will be needed momentarily. This will be needed momentarily. Next, create the Offer. A few things to note: @@ -276,7 +279,7 @@ Next, create the Offer. A few things to note: - Therefore, this Offer will request 1000000000000 mojos (1 XCH) - If a value is negative, it is being offered -Normally it's a good idea to set `validate_only` to `true` in order to make sure the Offer is valid. If everything looks OK, you can rerun the command with `validate_only` set to `false`, which is the case in the following example command: +Normally it's a good idea to set `validate_only` to `true` in order to make sure the Offer is valid. If everything looks OK, you can rerun the command with `validate_only` set to `false`, which is the case in the following example command: If everything looks OK, you can rerun the command with `validate_only` set to `false`, which is the case in the following example command: ```json chia rpc wallet create_offer_for_ids '{"offer":{"1":1000000000000,"93c7f48778b5758254bf8dcf6ce50bf203841e30735979d3a075b49342276d0d":-1},"fee":10000000,"driver_dict":{},"validate_only":false}' @@ -346,6 +349,25 @@ Response: "taken_offer": null, "trade_id": "0x0cb147ed072210499e1f33f288aa6233a37b7db0a49012d103a89168a08da1d0" } +} 0xaea628d51647c1f167ebf4bdfda0a05760231d7b6a71d7891cde9770f3d7a014) (28021 \"https://bafkreibspamgjmtkisxjqocjqpb3qjo4tqmjacrhe6d7jmddgdny5kenuu.ipfs.nftstorage.link\") (27765 \"https://bafkreibd6dchfc56by7fntdoe2viwdnbfbhowals4ivipugkzq6btx7koq.ipfs.nftstorage.link/\") (29550 . 1) (29556 . 1) (28008 . 0x32781864b26a44ae98384983c3b825dc9c18900a272787f4b06330db8ea88da5) (27752 . 0x23f0c4728bbe0e3e56cc6e26aa8b0da1284eeb0172e22a87d0cacc3c19dfea74))", + "type": "metadata", + "updater_hash": "0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b" + }, + "launcher_id": "0x93c7f48778b5758254bf8dcf6ce50bf203841e30735979d3a075b49342276d0d", + "launcher_ph": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9", + "type": "singleton" + } + }, + "offered": { + "93c7f48778b5758254bf8dcf6ce50bf203841e30735979d3a075b49342276d0d": 1 + }, + "requested": { + "xch": 1000000000000 + } + }, + "taken_offer": null, + "trade_id": "0x0cb147ed072210499e1f33f288aa6233a37b7db0a49012d103a89168a08da1d0" + } } ``` @@ -356,7 +378,7 @@ The Offer itself is the value of `offer`, at the top of the response. It is poss
Example 2: buy an NFT -This example will create an Offer to buy an NFT. By definition, the NFT cannot be in your wallet, so you first need to query the blockchain to obtain an NFT's info based on its ID alone: +This example will create an Offer to buy an NFT. This example will create an Offer to buy an NFT. By definition, the NFT cannot be in your wallet, so you first need to query the blockchain to obtain an NFT's info based on its ID alone: ```json chia rpc wallet nft_get_info '{"coin_id":"nft1ks2cqah7u6hjtj2q8vaem9a8e9n6v8rtxlzxzjs6zev8x3djevtq2kd8wn"}' @@ -366,6 +388,8 @@ Response: ```json { + "nft_info": { + "chain_info": "((117 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.gif\") (104 . 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\") (27765 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . { "nft_info": { "chain_info": "((117 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.gif\") (104 . 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\") (27765 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . 0x2267456bd2cef8ebc2f22a42947b068bc3b138284a587feda2edfe07a3577f50))", "data_hash": "0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b", @@ -401,9 +425,9 @@ Response: } ``` -The next step is to create a valid Offer that wallets will recognize. This includes creating a `driver_dict`, without which the Offer will be valid but wallets won't know how to interpret. The response from the above RPC call will include the information necessary to create the `driver_dict`, and the reference wallet uses a specific format for Offers. +The next step is to create a valid Offer that wallets will recognize. The next step is to create a valid Offer that wallets will recognize. This includes creating a `driver_dict`, without which the Offer will be valid but wallets won't know how to interpret. The response from the above RPC call will include the information necessary to create the `driver_dict`, and the reference wallet uses a specific format for Offers. The response from the above RPC call will include the information necessary to create the `driver_dict`, and the reference wallet uses a specific format for Offers. -The following is an example RPC call that includes all of the necessary information. However, it is formatted with multiple lines, so it will be difficult to copy/paste into a terminal. +The following is an example RPC call that includes all of the necessary information. The following is an example RPC call that includes all of the necessary information. However, it is formatted with multiple lines, so it will be difficult to copy/paste into a terminal. We'll give a few single-line, OS-specific examples afterward. @@ -439,7 +463,7 @@ chia rpc wallet create_offer_for_ids '{ }' ``` -Just as in Example 1, the response includes the Offer itself at the top of the JSON output. Copy the string beginning with `offer1` and paste it into the reference wallet to verify its validity: +Just as in Example 1, the response includes the Offer itself at the top of the JSON output. Copy the string beginning with `offer1` and paste it into the reference wallet to verify its validity: Copy the string beginning with `offer1` and paste it into the reference wallet to verify its validity: ```json { @@ -503,16 +527,35 @@ Just as in Example 1, the response includes the Offer itself at the top of the J "taken_offer": null, "trade_id": "0x7cd4ea3988ffe67388b7a12facff0499059000f99b0f9cb8b343c821b422ced9" } +} 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\") (27765 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . 0x2267456bd2cef8ebc2f22a42947b068bc3b138284a587feda2edfe07a3577f50))", + "type": "metadata", + "updater_hash": "0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b" + }, + "launcher_id": "0xb4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16", + "launcher_ph": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9", + "type": "singleton" + } + }, + "offered": { + "xch": 100000000000 + }, + "requested": { + "b4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16": 1 + } + }, + "taken_offer": null, + "trade_id": "0x7cd4ea3988ffe67388b7a12facff0499059000f99b0f9cb8b343c821b422ced9" + } } ``` -In Windows, quotes need to be escaped with backslashes. The following is the equivalent command, formatted for Windows, using a single line. Note that for the quotes surrounding URIs _three_ backslashes are required: +In Windows, quotes need to be escaped with backslashes. The following is the equivalent command, formatted for Windows, using a single line. In Windows, quotes need to be escaped with backslashes. The following is the equivalent command, formatted for Windows, using a single line. Note that for the quotes surrounding URIs _three_ backslashes are required: ```json -chia rpc wallet create_offer_for_ids '{ \"offer\":{ \"1\":-100000000000,\"b4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16\":1 }, \"fee\":10000, \"driver_dict\":{ \"b4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16\":{ \"type\":\"singleton\", \"launcher_id\":\"0xb4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16\", \"launcher_ph\":\"0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9\", \"also\":{ \"type\":\"metadata\", \"metadata\":\"((117 \\\"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.gif\\\") (104 . 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \\\"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\\\") (27765 \\\"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\\\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . 0x2267456bd2cef8ebc2f22a42947b068bc3b138284a587feda2edfe07a3577f50))\", \"updater_hash\":\"0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b\", \"also\":{ \"type\":\"ownership\", \"owner\":\"()\", \"transfer_program\":{ \"type\":\"royalty transfer program\", \"launcher_id\":\"0xb4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16\", \"royalty_address\":\"0x53c8e63bb7e61215db3c109a168a8c7ce7d1828c438b542abe9368c83ad3f0ff\", \"royalty_percentage\":\"300\" } } } } }, \"validate_only\":false }' +chia rpc wallet create_offer_for_ids '{ "offer":{ "1":-100000000000,"b4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16":1 }, "fee":10000, "driver_dict":{ "b4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16":{ "type":"singleton", "launcher_id":"0xb4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16", "launcher_ph":"0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9", "also":{ "type":"metadata", "metadata":"((117 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.gif\") (104 . 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\") (27765 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . 0x2267456bd2cef8ebc2f22a42947b068bc3b138284a587feda2edfe07a3577f50))", "updater_hash":"0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b", "also":{ "type":"ownership", "owner":"()", "transfer_program":{ "type":"royalty transfer program", "launcher_id":"0xb4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16", "royalty_address":"0x53c8e63bb7e61215db3c109a168a8c7ce7d1828c438b542abe9368c83ad3f0ff", "royalty_percentage":"300" } } } } }, "validate_only":false }' 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \\\"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\\\") (27765 \\\"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\\\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . 0x2267456bd2cef8ebc2f22a42947b068bc3b138284a587feda2edfe07a3577f50))\", \"updater_hash\":\"0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b\", \"also\":{ \"type\":\"ownership\", \"owner\":\"()\", \"transfer_program\":{ \"type\":\"royalty transfer program\", \"launcher_id\":\"0xb4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16\", \"royalty_address\":\"0x53c8e63bb7e61215db3c109a168a8c7ce7d1828c438b542abe9368c83ad3f0ff\", \"royalty_percentage\":\"300\" } } } } }, \"validate_only\":false }' ``` -In Linux and MacOS, the backslashes are generally not needed. Note, however, that one backslash is still needed in front of the quotes surrounding URIs. +In Linux and MacOS, the backslashes are generally not needed. In Linux and MacOS, the backslashes are generally not needed. Note, however, that one backslash is still needed in front of the quotes surrounding URIs. The following command is equivalent to the one above, but formatted for Linux and MacOS: @@ -525,7 +568,7 @@ chia rpc wallet create_offer_for_ids '{ "offer":{ "1":-100000000000,"b4158076fee
Example 3: Expiring Offer -In this example, we will offer 0.1 CATs (`Launcher ID: 91aa...004r`) in exchange for 1 TXCH (`Wallet ID: 1`). In addition, we will add an expiry timestamp so that this Offer will expire on Jan. 1, 2024: +In this example, we will offer 0.1 CATs (`Launcher ID: 91aa...004r`) in exchange for 1 TXCH (`Wallet ID: 1`). In addition, we will add an expiry timestamp so that this Offer will expire on Jan. 1, 2024: In addition, we will add an expiry timestamp so that this Offer will expire on Jan. 1, 2024: ```bash chia rpc wallet create_offer_for_ids '{"offer":{"1":1000000000000,"91aa49303fd325cf8029cc0ee5e19ac78ec33d641d63b50d0ba859309a73004d":-100},"fee":10000000,"driver_dict":{},"validate_only":false, "max_time": 1704070800}' @@ -599,7 +642,7 @@ Response: **Per the above note, this example will create a valid Offer, but the reference wallet currently (as of 2.1.0) will not be able to read it.** -In this example, we will offer 12.345 CATs (`Launcher ID: 91aa...004r`) in exchange for 1 TXCH (`Wallet ID: 1`). The offer will not be valid until UNIX timestamp `1700000000`, and it will expire after timestamp `1705000000`: +In this example, we will offer 12.345 CATs (`Launcher ID: 91aa...004r`) in exchange for 1 TXCH (`Wallet ID: 1`). The offer will not be valid until UNIX timestamp `1700000000`, and it will expire after timestamp `1705000000`: The offer will not be valid until UNIX timestamp `1700000000`, and it will expire after timestamp `1705000000`: ```bash chia rpc wallet create_offer_for_ids '{"offer":{"1":1000000000000,"91aa49303fd325cf8029cc0ee5e19ac78ec33d641d63b50d0ba859309a73004d":-12345},"fee":10000000,"driver_dict":{},"validate_only":false, "min_time": 1700000000, "max_time": 1705000000}' @@ -679,22 +722,22 @@ Usage: chia rpc wallet [OPTIONS] get_all_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------- | -| start | NUMBER | False | The first Offer to display, inclusive [Default: `0`] | -| end | NUMBER | False | The last Offer to display, exclusive [Default: `10`] | +| Flag | Type | Required | Description | +|:---------------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | +| start | NUMBER | False | The first Offer to display, inclusive [Default: `0`] | +| end | NUMBER | False | The last Offer to display, exclusive [Default: `10`] | | exclude_my_offers | BOOLEAN | False | If `true`, don't show Offers that originated from this wallet [Default: `false`] | | exclude_taken_offers | BOOLEAN | False | If `true`, don't show any Offers with a status of `CONFIRMED` [Default: `false`] | -| include_completed | BOOLEAN | False | If `true`, show completed Offers [Default: `false`] | -| sort_key | STRING | False | Optionally change the sort order of the results [Default: none] | -| reverse | BOOLEAN | False | If `true`, reverse the results [Default: `false`] | -| file_contents | BOOLEAN | False | If `true`, return a summary for the Offer. If `false`, only return the Offer's basic metadata [Default: `false`] | +| include_completed | BOOLEAN | False | If `true`, show completed Offers [Default: `false`] | +| sort_key | STRING | False | Optionally change the sort order of the results [Default: none] | +| reverse | BOOLEAN | False | If `true`, reverse the results [Default: `false`] | +| file_contents | BOOLEAN | False | If `true`, return a summary for the Offer. If `false`, only return the Offer's basic metadata [Default: `false`] |
Example @@ -765,6 +808,26 @@ Response: "trade_id": "0x039492f84708b8a585ddaa0dd44fa8db1a6afdad799b0900e37dfc9097f1f351" } ] +} 0x7b4981aba8d8e9dd25c40d6c696cb32eb7e281cb5629b29af64a2dd36495beb1) (28021 \"https://nftstorage.link/ipfs/bafybeiciasr5ifxl73lq6mv5otyaukrvb6326nk6cgcsny2x4wcjxxis3q/356.json\" \"ipfs://bafybeiciasr5ifxl73lq6mv5otyaukrvb6326nk6cgcsny2x4wcjxxis3q/356.json\") (27765 \"https://nftstorage.link/ipfs/bafybeidgtm4uobrog5kc7pn7bsmusdasf5w3drzqiitdjb3wragqrb7ola/LICENSE%20AGREEMENT.png\") (29550 . 1) (29556 . 1) (28008 . 0x9b40e3ed1d6b767886e6e8841aa1f6b60f8dc02cb98b2b876576c8dffc41995b) (27752 . 0x8e20454114197f82c7f50324df80170951fa3dfffd3b8860290207fb1e73743e))", + "type": "metadata", + "updater_hash": "0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b" + }, + "launcher_id": "0xafefeea01a615487ccfc2e3d70db69eceb5b715a81deba9e6b72b78067e61de6", + "launcher_ph": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9", + "type": "singleton" + } + }, + "offered": { + "afefeea01a615487ccfc2e3d70db69eceb5b715a81deba9e6b72b78067e61de6": 1 + }, + "requested": { + "xch": 2000000000000 + } + }, + "taken_offer": null, + "trade_id": "0x039492f84708b8a585ddaa0dd44fa8db1a6afdad799b0900e37dfc9097f1f351" + } + ] } ``` @@ -781,14 +844,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------- | +|:------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | | trade_id | STRING | True | The `trade_id` of the Offer | | file_contents | BOOLEAN | False | If `true`, return a summary for the Offer. If `false`, only return the Offer's basic metadata [Default: `false`] | @@ -862,6 +925,25 @@ Response: "taken_offer": "0x000000020000000000000000000000000000000000000000000000000000000000000000cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e70000000000000000ff02ffff01ff02ff0affff04ff02ffff04ff03ff80808080ffff04ffff01ffff333effff02ffff03ff05ffff01ff04ffff04ff0cffff04ffff02ff1effff04ff02ffff04ff09ff80808080ff808080ffff02ff16ffff04ff02ffff04ff19ffff04ffff02ff0affff04ff02ffff04ff0dff80808080ff808080808080ff8080ff0180ffff02ffff03ff05ffff01ff02ffff03ffff15ff29ff8080ffff01ff04ffff04ff08ff0980ffff02ff16ffff04ff02ffff04ff0dffff04ff0bff808080808080ffff01ff088080ff0180ffff010b80ff0180ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffffa01c16c8d75a4758c9f9ceaeefb15d882224d72d3b14d57310299583bf9a80bb13ffffa056b40242ba5961c0624a20cbdb36f7e60f8d5749a8d61a6faff899bb6559c5caff850189640200ff80808080c1d5924830950190008ec498deb7d1809c9203ed8f00e68a5097e2d0f2bdd41d4ffb6a0a459b3229b1b399922d70c0a9283aaad4c86401d4ee277fba31b31ee80000000000000001ff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc05868747470733a2f2f6261666b72656965733665736633746a646e68626470776535333562336f7a623277796b6a65326d7979756e6d61766161667879676771377979712e697066732e6e667473746f726167652e6c696e6b80ffff68a092f1245dcd2369c237d89ddf43b7643ab614926998c51ac054002df06343f8c4ffff826d75ffc05868747470733a2f2f6261666b7265696537697a73616773336b33336c65726d6f796c32627a65796c736f3364746f35726937656c7161747a756e7a6c7574336a6779692e697066732e6e667473746f726167652e6c696e6b80ffff826c75ffc07f68747470733a2f2f6261667962656968706e78763578696168786e78617866347a6566626e797273376b72726935736c636e716f6e376e6d79776c706e7070743678652e697066732e6e667473746f726167652e6c696e6b2f46726f6767792532304e46542532304c6963656e736525323041677265656d656e742e70646680ffff82736e01ffff82737401ffff826d68a09f4664034b6aded648b1d85e8392617276c7377628f917004f346e5749ed26c280ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff17ffff04ff0bffff04ffff02ff2fff5f80ff80808080808080ffff04ffff01ffffff82ad4cff0233ffff3e04ff81f601ffffff0102ffff02ffff03ff05ffff01ff02ff2affff04ff02ffff04ff0dffff04ffff0bff32ffff0bff3cff3480ffff0bff32ffff0bff32ffff0bff3cff2280ff0980ffff0bff32ff0bffff0bff3cff8080808080ff8080808080ffff010b80ff0180ff04ffff04ff38ffff04ffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ffff02ff2effff04ff02ffff04ffff02ffff03ff81afffff0181afffff010b80ff0180ff80808080ffff04ffff0bff3cff4f80ffff04ffff0bff3cff0580ff8080808080808080ff378080ff82016f80ffffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff2fffff01ff80ff808080808080808080ff0bff32ffff0bff3cff2880ffff0bff32ffff0bff32ffff0bff3cff2280ff0580ffff0bff32ffff02ff2affff04ff02ffff04ff07ffff04ffff0bff3cff3c80ff8080808080ffff0bff3cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff5fffff01ff02ffff03ffff09ff82011fff3880ffff01ff02ffff03ffff09ffff18ff82059f80ff3c80ffff01ff02ffff03ffff20ff81bf80ffff01ff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff82019fffff04ff82017fff80808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff0180ffff01ff02ffff03ffff09ff82011fff2c80ffff01ff02ffff03ffff20ff82017f80ffff01ff04ffff04ff24ffff04ffff0eff10ffff02ff2effff04ff02ffff04ff82019fff8080808080ff808080ffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ffff02ff0bffff04ff17ffff04ff2fffff04ff82019fff8080808080ff8080808080808080808080ffff01ff088080ff0180ffff01ff02ffff03ffff09ff82011fff2480ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0122ffff0dff82029f8080ffff01ff02ffff03ffff09ffff0cff82029fff80ffff010280ff1080ffff01ff0101ff8080ff0180ff8080ff018080ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff8080808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff018080ff018080ff0180ffff01ff02ff3affff04ff02ffff04ff05ffff04ff0bffff04ff81bfffff04ffff02ffff03ff82017fffff0182017fffff01ff02ff0bffff04ff17ffff04ff2fffff01ff808080808080ff0180ff8080808080808080ff0180ff018080ffff04ffff01a0c5abea79afaa001b5427dfa0c8cf42ca6f38f5841b78f9b3c252733eb2de2726ffff04ffff01a0700b5276a6ea93aeb290763ca90902a85e51287d468661961e425f3f95129a94ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff04ff82013fffff04ff80ffff04ffff02ffff03ffff22ff82013fffff20ffff09ff82013fff2f808080ffff01ff04ffff04ff10ffff04ffff0bffff02ff2effff04ff02ffff04ff09ffff04ff8205bfffff04ffff02ff3effff04ff02ffff04ffff04ff09ffff04ff82013fff1d8080ff80808080ff808080808080ff1580ff808080ffff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ffff01ff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ff0180ff80808080ffff01ff04ff2fffff01ff80ff80808080ff0180ffff04ffff01ffffff3f02ff04ff0101ffff822710ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff2cff1480ffff0bff2affff0bff2affff0bff2cff3c80ff0980ffff0bff2aff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ff17ffff01ff04ffff04ff10ffff04ffff0bff81a7ffff02ff3effff04ff02ffff04ffff04ff2fffff04ffff04ff05ffff04ffff05ffff14ffff12ff47ff0b80ff128080ffff04ffff04ff05ff8080ff80808080ff808080ff8080808080ff808080ffff02ff16ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fff8080808080808080ff8080ff0180ffff0bff2affff0bff2cff1880ffff0bff2affff0bff2affff0bff2cff3c80ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01a0ea0a501540d9c0ec351e91dd124e29e86af834acd7d79e76d1e9202b2a414b58ffff04ffff0182012cff0180808080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0915d5ba6e9d72fd792e02c28fc6be7cb6f73ddb34a1df9caae8585f26a73c72a88d14f5e7ceae20434f5311a48d530b0ff018080ff018080808080ff018080808080ff01808080ffffa0dd4daf660c3c05c2c233a1c27f06c0872eea9b22280d9f0e5e5028df63a5ea68ffa0669c0b472769c2c84f8ede0ce01a5a556537bed023d2a98ed26f6c182986ab49ff0180ff01ffffffff80ffff01ffff81f6ff80ffffff850189640200ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ff8080ffff33ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e7ff01ffffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ffff3fffa033cb40ac40c0391d2831bc08c1954a4bf429740ac648b5850fca7f478a58ccdc8080ff8080808080878ce79554fe049e8bb6a58bafb91ca12abb78aa04ac551b15db778f89973f6912729c9ee4a80c08788125274a0787ce0027b5af8aaf12ee0e0a6e749daaec28441a59418c58e04ebdef02780961242d76aa1679a4276a431b67245cd2597672", "trade_id": "0x0958db8393a63dab6b2afa78abbfe91a0487e5b06e25174ec8c49d383f18afc0" } +} 0x92f1245dcd2369c237d89ddf43b7643ab614926998c51ac054002df06343f8c4) (28021 \"https://bafkreie7izsags3k33lermoyl2bzeylso3dto5ri7elqatzunzlut3jgyi.ipfs.nftstorage.link\") (27765 \"https://bafybeihpnxv5xiahxnxaxf4zefbnyrs7krri5slcnqon7nmywlpnppt6xe.ipfs.nftstorage.link/Froggy%20NFT%20License%20Agreement.pdf\") (29550 . 1) (29556 . 1) (28008 . 0x9f4664034b6aded648b1d85e8392617276c7377628f917004f346e5749ed26c2))", + "type": "metadata", + "updater_hash": "0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b" + }, + "launcher_id": "0x87db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719", + "launcher_ph": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9", + "type": "singleton" + } + }, + "offered": { + "87db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719": 1 + }, + "requested": { + "xch": 6600000000 + } + }, + "taken_offer": "0x000000020000000000000000000000000000000000000000000000000000000000000000cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e70000000000000000ff02ffff01ff02ff0affff04ff02ffff04ff03ff80808080ffff04ffff01ffff333effff02ffff03ff05ffff01ff04ffff04ff0cffff04ffff02ff1effff04ff02ffff04ff09ff80808080ff808080ffff02ff16ffff04ff02ffff04ff19ffff04ffff02ff0affff04ff02ffff04ff0dff80808080ff808080808080ff8080ff0180ffff02ffff03ff05ffff01ff02ffff03ffff15ff29ff8080ffff01ff04ffff04ff08ff0980ffff02ff16ffff04ff02ffff04ff0dffff04ff0bff808080808080ffff01ff088080ff0180ffff010b80ff0180ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffffa01c16c8d75a4758c9f9ceaeefb15d882224d72d3b14d57310299583bf9a80bb13ffffa056b40242ba5961c0624a20cbdb36f7e60f8d5749a8d61a6faff899bb6559c5caff850189640200ff80808080c1d5924830950190008ec498deb7d1809c9203ed8f00e68a5097e2d0f2bdd41d4ffb6a0a459b3229b1b399922d70c0a9283aaad4c86401d4ee277fba31b31ee80000000000000001ff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc05868747470733a2f2f6261666b72656965733665736633746a646e68626470776535333562336f7a623277796b6a65326d7979756e6d61766161667879676771377979712e697066732e6e667473746f726167652e6c696e6b80ffff68a092f1245dcd2369c237d89ddf43b7643ab614926998c51ac054002df06343f8c4ffff826d75ffc05868747470733a2f2f6261666b7265696537697a73616773336b33336c65726d6f796c32627a65796c736f3364746f35726937656c7161747a756e7a6c7574336a6779692e697066732e6e667473746f726167652e6c696e6b80ffff826c75ffc07f68747470733a2f2f6261667962656968706e78763578696168786e78617866347a6566626e797273376b72726935736c636e716f6e376e6d79776c706e7070743678652e697066732e6e667473746f726167652e6c696e6b2f46726f6767792532304e46542532304c6963656e736525323041677265656d656e742e70646680ffff82736e01ffff82737401ffff826d68a09f4664034b6aded648b1d85e8392617276c7377628f917004f346e5749ed26c280ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff17ffff04ff0bffff04ffff02ff2fff5f80ff80808080808080ffff04ffff01ffffff82ad4cff0233ffff3e04ff81f601ffffff0102ffff02ffff03ff05ffff01ff02ff2affff04ff02ffff04ff0dffff04ffff0bff32ffff0bff3cff3480ffff0bff32ffff0bff32ffff0bff3cff2280ff0980ffff0bff32ff0bffff0bff3cff8080808080ff8080808080ffff010b80ff0180ff04ffff04ff38ffff04ffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ffff02ff2effff04ff02ffff04ffff02ffff03ff81afffff0181afffff010b80ff0180ff80808080ffff04ffff0bff3cff4f80ffff04ffff0bff3cff0580ff8080808080808080ff378080ff82016f80ffffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff2fffff01ff80ff808080808080808080ff0bff32ffff0bff3cff2880ffff0bff32ffff0bff32ffff0bff3cff2280ff0580ffff0bff32ffff02ff2affff04ff02ffff04ff07ffff04ffff0bff3cff3c80ff8080808080ffff0bff3cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff5fffff01ff02ffff03ffff09ff82011fff3880ffff01ff02ffff03ffff09ffff18ff82059f80ff3c80ffff01ff02ffff03ffff20ff81bf80ffff01ff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff82019fffff04ff82017fff80808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff0180ffff01ff02ffff03ffff09ff82011fff2c80ffff01ff02ffff03ffff20ff82017f80ffff01ff04ffff04ff24ffff04ffff0eff10ffff02ff2effff04ff02ffff04ff82019fff8080808080ff808080ffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ffff02ff0bffff04ff17ffff04ff2fffff04ff82019fff8080808080ff8080808080808080808080ffff01ff088080ff0180ffff01ff02ffff03ffff09ff82011fff2480ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0122ffff0dff82029f8080ffff01ff02ffff03ffff09ffff0cff82029fff80ffff010280ff1080ffff01ff0101ff8080ff0180ff8080ff018080ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff8080808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff018080ff018080ff0180ffff01ff02ff3affff04ff02ffff04ff05ffff04ff0bffff04ff81bfffff04ffff02ffff03ff82017fffff0182017fffff01ff02ff0bffff04ff17ffff04ff2fffff01ff808080808080ff0180ff8080808080808080ff0180ff018080ffff04ffff01a0c5abea79afaa001b5427dfa0c8cf42ca6f38f5841b78f9b3c252733eb2de2726ffff04ffff01a0700b5276a6ea93aeb290763ca90902a85e51287d468661961e425f3f95129a94ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff04ff82013fffff04ff80ffff04ffff02ffff03ffff22ff82013fffff20ffff09ff82013fff2f808080ffff01ff04ffff04ff10ffff04ffff0bffff02ff2effff04ff02ffff04ff09ffff04ff8205bfffff04ffff02ff3effff04ff02ffff04ffff04ff09ffff04ff82013fff1d8080ff80808080ff808080808080ff1580ff808080ffff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ffff01ff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ff0180ff80808080ffff01ff04ff2fffff01ff80ff80808080ff0180ffff04ffff01ffffff3f02ff04ff0101ffff822710ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff2cff1480ffff0bff2affff0bff2affff0bff2cff3c80ff0980ffff0bff2aff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ff17ffff01ff04ffff04ff10ffff04ffff0bff81a7ffff02ff3effff04ff02ffff04ffff04ff2fffff04ffff04ff05ffff04ffff05ffff14ffff12ff47ff0b80ff128080ffff04ffff04ff05ff8080ff80808080ff808080ff8080808080ff808080ffff02ff16ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fff8080808080808080ff8080ff0180ffff0bff2affff0bff2cff1880ffff0bff2affff0bff2affff0bff2cff3c80ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01a0ea0a501540d9c0ec351e91dd124e29e86af834acd7d79e76d1e9202b2a414b58ffff04ffff0182012cff0180808080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0915d5ba6e9d72fd792e02c28fc6be7cb6f73ddb34a1df9caae8585f26a73c72a88d14f5e7ceae20434f5311a48d530b0ff018080ff018080808080ff018080808080ff01808080ffffa0dd4daf660c3c05c2c233a1c27f06c0872eea9b22280d9f0e5e5028df63a5ea68ffa0669c0b472769c2c84f8ede0ce01a5a556537bed023d2a98ed26f6c182986ab49ff0180ff01ffffffff80ffff01ffff81f6ff80ffffff850189640200ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ff8080ffff33ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e7ff01ffffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ffff3fffa033cb40ac40c0391d2831bc08c1954a4bf429740ac648b5850fca7f478a58ccdc8080ff8080808080878ce79554fe049e8bb6a58bafb91ca12abb78aa04ac551b15db778f89973f6912729c9ee4a80c08788125274a0787ce0027b5af8aaf12ee0e0a6e749daaec28441a59418c58e04ebdef02780961242d76aa1679a4276a431b67245cd2597672", + "trade_id": "0x0958db8393a63dab6b2afa78abbfe91a0487e5b06e25174ec8c49d383f18afc0" + } } ``` @@ -878,7 +960,7 @@ Functionality: Obtain a count of the number of offers created and taken with thi Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -915,14 +997,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer_summary [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :------ | :------- | :-------------------------------------------------------------------- | +|:-------- |:------- |:-------- |:--------------------------------------------------------------------- | | offer | STRING | True | The text of the Offer to summarize | | advanced | BOOLEAN | False | Show advanced information, including expiration time [Default: false] | @@ -972,6 +1054,22 @@ Response: "b4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16": 1 } } +} 0x7a6eedd652d0e6d315e691e87f5098e858bfe646122d1a8759a40fcf3efb024b) (28021 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/880.json\") (27765 \"https://bafybeigzcazxeu7epmm4vtkuadrvysv74lbzzbl2evphtae6k57yhgynp4.ipfs.nftstorage.link/license.pdf\") (29550 . 1) (29556 . 1) (28008 . 0xb2214ff82ef10a57f653fd09e761c3fabe630996300f90f6fbefcb4f65904c8b) (27752 . 0x2267456bd2cef8ebc2f22a42947b068bc3b138284a587feda2edfe07a3577f50))", + "type": "metadata", + "updater_hash": "0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b" + }, + "launcher_id": "0xb4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16", + "launcher_ph": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9", + "type": "singleton" + } + }, + "offered": { + "xch": 100000000000 + }, + "requested": { + "b4158076fee6af25c9403b3b9d97a7c967a61c6b37c4614a1a16587345b2cb16": 1 + } + } } ``` @@ -1029,14 +1127,14 @@ Usage: chia rpc wallet [OPTIONS] take_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :-------- | :------- | :-------------------------------------------------------------------- | +|:----- |:--------- |:-------- |:--------------------------------------------------------------------- | | offer | FILE PATH | True | The text of the Offer to take (must be in the `PENDING_ACCEPT` state) | | fee | NUMBER | False | An optional fee (in mojos) to include with the Offer [Default: `0`] | @@ -1111,6 +1209,25 @@ Response: "taken_offer": "0x000000020000000000000000000000000000000000000000000000000000000000000000cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e70000000000000000ff02ffff01ff02ff0affff04ff02ffff04ff03ff80808080ffff04ffff01ffff333effff02ffff03ff05ffff01ff04ffff04ff0cffff04ffff02ff1effff04ff02ffff04ff09ff80808080ff808080ffff02ff16ffff04ff02ffff04ff19ffff04ffff02ff0affff04ff02ffff04ff0dff80808080ff808080808080ff8080ff0180ffff02ffff03ff05ffff01ff02ffff03ffff15ff29ff8080ffff01ff04ffff04ff08ff0980ffff02ff16ffff04ff02ffff04ff0dffff04ff0bff808080808080ffff01ff088080ff0180ffff010b80ff0180ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffffa01c16c8d75a4758c9f9ceaeefb15d882224d72d3b14d57310299583bf9a80bb13ffffa056b40242ba5961c0624a20cbdb36f7e60f8d5749a8d61a6faff899bb6559c5caff850189640200ff80808080c1d5924830950190008ec498deb7d1809c9203ed8f00e68a5097e2d0f2bdd41d4ffb6a0a459b3229b1b399922d70c0a9283aaad4c86401d4ee277fba31b31ee80000000000000001ff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc05868747470733a2f2f6261666b72656965733665736633746a646e68626470776535333562336f7a623277796b6a65326d7979756e6d61766161667879676771377979712e697066732e6e667473746f726167652e6c696e6b80ffff68a092f1245dcd2369c237d89ddf43b7643ab614926998c51ac054002df06343f8c4ffff826d75ffc05868747470733a2f2f6261666b7265696537697a73616773336b33336c65726d6f796c32627a65796c736f3364746f35726937656c7161747a756e7a6c7574336a6779692e697066732e6e667473746f726167652e6c696e6b80ffff826c75ffc07f68747470733a2f2f6261667962656968706e78763578696168786e78617866347a6566626e797273376b72726935736c636e716f6e376e6d79776c706e7070743678652e697066732e6e667473746f726167652e6c696e6b2f46726f6767792532304e46542532304c6963656e736525323041677265656d656e742e70646680ffff82736e01ffff82737401ffff826d68a09f4664034b6aded648b1d85e8392617276c7377628f917004f346e5749ed26c280ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff17ffff04ff0bffff04ffff02ff2fff5f80ff80808080808080ffff04ffff01ffffff82ad4cff0233ffff3e04ff81f601ffffff0102ffff02ffff03ff05ffff01ff02ff2affff04ff02ffff04ff0dffff04ffff0bff32ffff0bff3cff3480ffff0bff32ffff0bff32ffff0bff3cff2280ff0980ffff0bff32ff0bffff0bff3cff8080808080ff8080808080ffff010b80ff0180ff04ffff04ff38ffff04ffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ffff02ff2effff04ff02ffff04ffff02ffff03ff81afffff0181afffff010b80ff0180ff80808080ffff04ffff0bff3cff4f80ffff04ffff0bff3cff0580ff8080808080808080ff378080ff82016f80ffffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff2fffff01ff80ff808080808080808080ff0bff32ffff0bff3cff2880ffff0bff32ffff0bff32ffff0bff3cff2280ff0580ffff0bff32ffff02ff2affff04ff02ffff04ff07ffff04ffff0bff3cff3c80ff8080808080ffff0bff3cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff5fffff01ff02ffff03ffff09ff82011fff3880ffff01ff02ffff03ffff09ffff18ff82059f80ff3c80ffff01ff02ffff03ffff20ff81bf80ffff01ff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff82019fffff04ff82017fff80808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff0180ffff01ff02ffff03ffff09ff82011fff2c80ffff01ff02ffff03ffff20ff82017f80ffff01ff04ffff04ff24ffff04ffff0eff10ffff02ff2effff04ff02ffff04ff82019fff8080808080ff808080ffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ffff02ff0bffff04ff17ffff04ff2fffff04ff82019fff8080808080ff8080808080808080808080ffff01ff088080ff0180ffff01ff02ffff03ffff09ff82011fff2480ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0122ffff0dff82029f8080ffff01ff02ffff03ffff09ffff0cff82029fff80ffff010280ff1080ffff01ff0101ff8080ff0180ff8080ff018080ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff8080808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff018080ff018080ff0180ffff01ff02ff3affff04ff02ffff04ff05ffff04ff0bffff04ff81bfffff04ffff02ffff03ff82017fffff0182017fffff01ff02ff0bffff04ff17ffff04ff2fffff01ff808080808080ff0180ff8080808080808080ff0180ff018080ffff04ffff01a0c5abea79afaa001b5427dfa0c8cf42ca6f38f5841b78f9b3c252733eb2de2726ffff04ffff01a0700b5276a6ea93aeb290763ca90902a85e51287d468661961e425f3f95129a94ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff04ff82013fffff04ff80ffff04ffff02ffff03ffff22ff82013fffff20ffff09ff82013fff2f808080ffff01ff04ffff04ff10ffff04ffff0bffff02ff2effff04ff02ffff04ff09ffff04ff8205bfffff04ffff02ff3effff04ff02ffff04ffff04ff09ffff04ff82013fff1d8080ff80808080ff808080808080ff1580ff808080ffff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ffff01ff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ff0180ff80808080ffff01ff04ff2fffff01ff80ff80808080ff0180ffff04ffff01ffffff3f02ff04ff0101ffff822710ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff2cff1480ffff0bff2affff0bff2affff0bff2cff3c80ff0980ffff0bff2aff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ff17ffff01ff04ffff04ff10ffff04ffff0bff81a7ffff02ff3effff04ff02ffff04ffff04ff2fffff04ffff04ff05ffff04ffff05ffff14ffff12ff47ff0b80ff128080ffff04ffff04ff05ff8080ff80808080ff808080ff8080808080ff808080ffff02ff16ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fff8080808080808080ff8080ff0180ffff0bff2affff0bff2cff1880ffff0bff2affff0bff2affff0bff2cff3c80ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01a0ea0a501540d9c0ec351e91dd124e29e86af834acd7d79e76d1e9202b2a414b58ffff04ffff0182012cff0180808080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0915d5ba6e9d72fd792e02c28fc6be7cb6f73ddb34a1df9caae8585f26a73c72a88d14f5e7ceae20434f5311a48d530b0ff018080ff018080808080ff018080808080ff01808080ffffa0dd4daf660c3c05c2c233a1c27f06c0872eea9b22280d9f0e5e5028df63a5ea68ffa0669c0b472769c2c84f8ede0ce01a5a556537bed023d2a98ed26f6c182986ab49ff0180ff01ffffffff80ffff01ffff81f6ff80ffffff850189640200ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ff8080ffff33ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e7ff01ffffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ffff3fffa033cb40ac40c0391d2831bc08c1954a4bf429740ac648b5850fca7f478a58ccdc8080ff8080808080878ce79554fe049e8bb6a58bafb91ca12abb78aa04ac551b15db778f89973f6912729c9ee4a80c08788125274a0787ce0027b5af8aaf12ee0e0a6e749daaec28441a59418c58e04ebdef02780961242d76aa1679a4276a431b67245cd2597672", "trade_id": "0x0958db8393a63dab6b2afa78abbfe91a0487e5b06e25174ec8c49d383f18afc0" } +} 0x92f1245dcd2369c237d89ddf43b7643ab614926998c51ac054002df06343f8c4) (28021 \"https://bafkreie7izsags3k33lermoyl2bzeylso3dto5ri7elqatzunzlut3jgyi.ipfs.nftstorage.link\") (27765 \"https://bafybeihpnxv5xiahxnxaxf4zefbnyrs7krri5slcnqon7nmywlpnppt6xe.ipfs.nftstorage.link/Froggy%20NFT%20License%20Agreement.pdf\") (29550 . 1) (29556 . 1) (28008 . 0x9f4664034b6aded648b1d85e8392617276c7377628f917004f346e5749ed26c2))", + "type": "metadata", + "updater_hash": "0xfe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78b" + }, + "launcher_id": "0x87db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719", + "launcher_ph": "0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9", + "type": "singleton" + } + }, + "offered": { + "87db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719": 1 + }, + "requested": { + "xch": 6600000000 + } + }, + "taken_offer": "0x000000020000000000000000000000000000000000000000000000000000000000000000cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e70000000000000000ff02ffff01ff02ff0affff04ff02ffff04ff03ff80808080ffff04ffff01ffff333effff02ffff03ff05ffff01ff04ffff04ff0cffff04ffff02ff1effff04ff02ffff04ff09ff80808080ff808080ffff02ff16ffff04ff02ffff04ff19ffff04ffff02ff0affff04ff02ffff04ff0dff80808080ff808080808080ff8080ff0180ffff02ffff03ff05ffff01ff02ffff03ffff15ff29ff8080ffff01ff04ffff04ff08ff0980ffff02ff16ffff04ff02ffff04ff0dffff04ff0bff808080808080ffff01ff088080ff0180ffff010b80ff0180ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff1effff04ff02ffff04ff09ff80808080ffff02ff1effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffffa01c16c8d75a4758c9f9ceaeefb15d882224d72d3b14d57310299583bf9a80bb13ffffa056b40242ba5961c0624a20cbdb36f7e60f8d5749a8d61a6faff899bb6559c5caff850189640200ff80808080c1d5924830950190008ec498deb7d1809c9203ed8f00e68a5097e2d0f2bdd41d4ffb6a0a459b3229b1b399922d70c0a9283aaad4c86401d4ee277fba31b31ee80000000000000001ff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc05868747470733a2f2f6261666b72656965733665736633746a646e68626470776535333562336f7a623277796b6a65326d7979756e6d61766161667879676771377979712e697066732e6e667473746f726167652e6c696e6b80ffff68a092f1245dcd2369c237d89ddf43b7643ab614926998c51ac054002df06343f8c4ffff826d75ffc05868747470733a2f2f6261666b7265696537697a73616773336b33336c65726d6f796c32627a65796c736f3364746f35726937656c7161747a756e7a6c7574336a6779692e697066732e6e667473746f726167652e6c696e6b80ffff826c75ffc07f68747470733a2f2f6261667962656968706e78763578696168786e78617866347a6566626e797273376b72726935736c636e716f6e376e6d79776c706e7070743678652e697066732e6e667473746f726167652e6c696e6b2f46726f6767792532304e46542532304c6963656e736525323041677265656d656e742e70646680ffff82736e01ffff82737401ffff826d68a09f4664034b6aded648b1d85e8392617276c7377628f917004f346e5749ed26c280ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff17ffff04ff0bffff04ffff02ff2fff5f80ff80808080808080ffff04ffff01ffffff82ad4cff0233ffff3e04ff81f601ffffff0102ffff02ffff03ff05ffff01ff02ff2affff04ff02ffff04ff0dffff04ffff0bff32ffff0bff3cff3480ffff0bff32ffff0bff32ffff0bff3cff2280ff0980ffff0bff32ff0bffff0bff3cff8080808080ff8080808080ffff010b80ff0180ff04ffff04ff38ffff04ffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ffff02ff2effff04ff02ffff04ffff02ffff03ff81afffff0181afffff010b80ff0180ff80808080ffff04ffff0bff3cff4f80ffff04ffff0bff3cff0580ff8080808080808080ff378080ff82016f80ffffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff2fffff01ff80ff808080808080808080ff0bff32ffff0bff3cff2880ffff0bff32ffff0bff32ffff0bff3cff2280ff0580ffff0bff32ffff02ff2affff04ff02ffff04ff07ffff04ffff0bff3cff3c80ff8080808080ffff0bff3cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff5fffff01ff02ffff03ffff09ff82011fff3880ffff01ff02ffff03ffff09ffff18ff82059f80ff3c80ffff01ff02ffff03ffff20ff81bf80ffff01ff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff82019fffff04ff82017fff80808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff0180ffff01ff02ffff03ffff09ff82011fff2c80ffff01ff02ffff03ffff20ff82017f80ffff01ff04ffff04ff24ffff04ffff0eff10ffff02ff2effff04ff02ffff04ff82019fff8080808080ff808080ffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ffff02ff0bffff04ff17ffff04ff2fffff04ff82019fff8080808080ff8080808080808080808080ffff01ff088080ff0180ffff01ff02ffff03ffff09ff82011fff2480ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0122ffff0dff82029f8080ffff01ff02ffff03ffff09ffff0cff82029fff80ffff010280ff1080ffff01ff0101ff8080ff0180ff8080ff018080ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff8080808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff018080ff018080ff0180ffff01ff02ff3affff04ff02ffff04ff05ffff04ff0bffff04ff81bfffff04ffff02ffff03ff82017fffff0182017fffff01ff02ff0bffff04ff17ffff04ff2fffff01ff808080808080ff0180ff8080808080808080ff0180ff018080ffff04ffff01a0c5abea79afaa001b5427dfa0c8cf42ca6f38f5841b78f9b3c252733eb2de2726ffff04ffff01a0700b5276a6ea93aeb290763ca90902a85e51287d468661961e425f3f95129a94ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff04ff82013fffff04ff80ffff04ffff02ffff03ffff22ff82013fffff20ffff09ff82013fff2f808080ffff01ff04ffff04ff10ffff04ffff0bffff02ff2effff04ff02ffff04ff09ffff04ff8205bfffff04ffff02ff3effff04ff02ffff04ffff04ff09ffff04ff82013fff1d8080ff80808080ff808080808080ff1580ff808080ffff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ffff01ff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ff0180ff80808080ffff01ff04ff2fffff01ff80ff80808080ff0180ffff04ffff01ffffff3f02ff04ff0101ffff822710ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff2cff1480ffff0bff2affff0bff2affff0bff2cff3c80ff0980ffff0bff2aff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ff17ffff01ff04ffff04ff10ffff04ffff0bff81a7ffff02ff3effff04ff02ffff04ffff04ff2fffff04ffff04ff05ffff04ffff05ffff14ffff12ff47ff0b80ff128080ffff04ffff04ff05ff8080ff80808080ff808080ff8080808080ff808080ffff02ff16ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fff8080808080808080ff8080ff0180ffff0bff2affff0bff2cff1880ffff0bff2affff0bff2affff0bff2cff3c80ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa087db6520e42d8889d9ed6a7d2aa8f6f183b1977b0f186fbe2341bd29ae1fb719a0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01a0ea0a501540d9c0ec351e91dd124e29e86af834acd7d79e76d1e9202b2a414b58ffff04ffff0182012cff0180808080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0915d5ba6e9d72fd792e02c28fc6be7cb6f73ddb34a1df9caae8585f26a73c72a88d14f5e7ceae20434f5311a48d530b0ff018080ff018080808080ff018080808080ff01808080ffffa0dd4daf660c3c05c2c233a1c27f06c0872eea9b22280d9f0e5e5028df63a5ea68ffa0669c0b472769c2c84f8ede0ce01a5a556537bed023d2a98ed26f6c182986ab49ff0180ff01ffffffff80ffff01ffff81f6ff80ffffff850189640200ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ff8080ffff33ffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e7ff01ffffa0cfbfdeed5c4ca2de3d0bf520b9cb4bb7743a359bd2e6a188d19ce7dffc21d3e78080ffff3fffa033cb40ac40c0391d2831bc08c1954a4bf429740ac648b5850fca7f478a58ccdc8080ff8080808080878ce79554fe049e8bb6a58bafb91ca12abb78aa04ac551b15db778f89973f6912729c9ee4a80c08788125274a0787ce0027b5af8aaf12ee0e0a6e749daaec28441a59418c58e04ebdef02780961242d76aa1679a4276a431b67245cd2597672", + "trade_id": "0x0958db8393a63dab6b2afa78abbfe91a0487e5b06e25174ec8c49d383f18afc0" + } } ``` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/rpc.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/rpc.md index 6fb237199f..5940ad2056 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/rpc.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/rpc.md @@ -86,7 +86,7 @@ wsapp.close() #### WebSockets Example Output -(Long strings have been replace with `XxXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX`.) +(Long strings have been replaced with `XxXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX`.) ```json Starting Something @@ -155,11 +155,20 @@ namespace ChiaExamples ## Services -The service RPC APIs are documented in the following sections: TODO: add links here and create the other sections - -- Shared: RPCs that all services share -- Full Node -- Farmer -- Harvester -- Timelord -- Wallet (This API is still a WIP and likely to change soon) +| Service | Managed Objects | Associated API | Associated RPC API | +| ----------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | +| FarmerService | [Farmer](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/farmer/farmer.py) | [FarmerAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/farmer/farmer_api.py) | [FarmerRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/farmer_rpc_api.py) | +| FullNodeService | [FullNode](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/full_node/full_node.py) | [FullNodeAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/full_node/full_node_api.py) | [FullNodeRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/full_node_rpc_api.py) | +| HarvesterService | [Harvester](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/harvester/harvester.py) | [HarvesterAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/harvester/harvester_api.py) | [HarvesterRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/harvester_rpc_api.py) | +| IntroducerService | [Introducer](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/introducer/introducer.py) | [IntroducerAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/introducer/introducer_api.py) | [FullNodeRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/full_node_rpc_api.py) | +| CrawlerService | [Crawler](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/seeder/crawler.py) | [CrawlerAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/seeder/crawler_api.py) | [CrawlerRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/crawler_rpc_api.py) | +| DataLayerService | [DataLayer](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/data_layer/data_layer.py) | [DataLayerAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/data_layer/data_layer_api.py) | [DataLayerRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/data_layer_rpc_api.py) | +| TimelordService | [Timelord](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/timelord/timelord.py) | [TimelordAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/timelord/timelord_api.py) | [TimelordRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/timelord_rpc_api.py) | +| WalletService | [WalletNode](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/wallet_node.py) | [WalletNodeAPI](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/wallet_node_api.py) | [WalletRpcApi](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/rpc/wallet_rpc_api.py) | + +**Explanation:** Each service is composed of a managed object, an API for control, and an RPC API for remote control. The combination of these into the service is controlled by the [service alias](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/types/aliases.py) types. + +- **Service**: This column lists the different manager services within the Chia system. +- **Managed Objects**: This column details the core entities or components that each service oversees. +- **Associated API**: This column specifies the API class associated with each service. This API class defines the interface for interacting with the corresponding managed objects. +- **Associated RPC API**: This column lists the RPC API class associated with each service. This RPC API class allows for remote control of the managed objects through Remote Procedure Calls (RPC). diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md index e12f103bda..5bb3f8f0df 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md @@ -52,17 +52,17 @@ Usage: chia rpc full_node [OPTIONS] farm_block [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -| :----------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| address | True | The address to use to farm the block | +| Parameter | Required | Description | +|:-------------------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| address | True | The address to use to farm the block | | guarantee_tx_block | False | Set to `True` to farm a transaction block (ie, farm new blocks until a tx block is farmed); set to `False` to farm the next block, which could also be a transaction block, but is not guaranteed (Default: `False`) | -| blocks | False | Number of blocks to farm. If `guarantee_tx_block` is `True`, then each block will be a transaction block (Default: 1) | +| blocks | False | Number of blocks to farm. If `guarantee_tx_block` is `True`, then each block will be a transaction block (Default: 1) |
Example 1 @@ -115,7 +115,7 @@ Usage: chia rpc full_node [OPTIONS] get_all_blocks [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -222,14 +222,14 @@ Usage: chia rpc full_node [OPTIONS] get_all_coins [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -| :------------------ | :------- | :------------------------------------------------------------------------------------ | +| Parameter | Required | Description | +|:--------------------- |:-------- |:------------------------------------------------------------------------------------- | | include_spent_coins | False | Boolean, if `True` then spent coins will be included in the result (Default: `False`) |
@@ -287,7 +287,7 @@ Usage: chia rpc full_node [OPTIONS] get_all_puzzle_hashes [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -332,7 +332,7 @@ Usage: chia rpc full_node [OPTIONS] get_auto_farming [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -367,7 +367,7 @@ Usage: chia rpc full_node [OPTIONS] get_farming_ph [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -414,18 +414,18 @@ Usage: chia rpc full_node [OPTIONS] reorg_blocks [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -| :------------------- | :------- | :------------------------------------------------------------------ | +| Parameter | Required | Description | +|:------------------------ |:-------- |:------------------------------------------------------------------- | | num_of_blocks_to_rev | False | The number of blocks to go back (Default: 1) | -| num_of_new_blocks | False | The number of blocks to add (Default: 1) | -| revert_all_blocks | False | Boolean, set to `True` to fork all blocks (Default: `False`) | -| random_seed | False | String, used to randomize the seed, which will differentiate reorgs | +| num_of_new_blocks | False | The number of blocks to add (Default: 1) | +| revert_all_blocks | False | Boolean, set to `True` to fork all blocks (Default: `False`) | +| random_seed | False | String, used to randomize the seed, which will differentiate reorgs |
Example 1 @@ -478,14 +478,14 @@ Usage: chia rpc full_node [OPTIONS] revert_blocks [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -| :---------------- | :------- | :------------------------------------------------------------- | +| Parameter | Required | Description | +|:------------------- |:-------- |:-------------------------------------------------------------- | | num_of_blocks | False | The number of blocks to revert (Default: 1) | | delete_all_blocks | False | Boolean, set to `True` to revert all blocks (Default: `False`) | @@ -540,14 +540,14 @@ Usage: chia rpc full_node [OPTIONS] set_auto_farming [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :---------------------------------------- | +|:--------- |:-------- |:----------------------------------------- | | auto_farm | True | Boolean to enable or disable auto farming |
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md index aad0afd2ce..ac16319ca2 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md @@ -37,14 +37,14 @@ Usage: chia rpc wallet [OPTIONS] vc_add_proofs [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :--------- | :------- | :---------------------------------------------------- | +|:--------- |:---------- |:-------- |:----------------------------------------------------- | | proofs | DICTIONARY | True | A dictionary of key/value pairs to be added as proofs |
@@ -77,14 +77,14 @@ Usage: chia rpc wallet [OPTIONS] vc_get [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------------------- | +|:--------- |:------ |:-------- |:------------------------------------------ | | vc_id | STRING | True | The launcher ID of a Verifiable Credential | This RPC returns the `vc_record` representing the specified Verifiable Credential @@ -142,14 +142,14 @@ Usage: chia rpc wallet [OPTIONS] vc_get_list [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :------ | :------- | :---------------------------------------------------- | +|:--------- |:------- |:-------- |:----------------------------------------------------- | | start | INTEGER | False | The index to start the list at [default: 0] | | count | INTEGER | False | The maximum number of results to return [default: 50] | @@ -214,14 +214,14 @@ Usage: chia rpc wallet [OPTIONS] vc_get_proofs_for_root [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------------------------------------------------- | +|:--------- |:------ |:-------- |:------------------------------------------------------------------------ | | root | STRING | True | The tree hash of a set of proofs that have been stored in the dictionary | This RPC returns a dictionary of root hashes mapped to dictionaries of key value pairs of 'proofs'. @@ -258,14 +258,14 @@ Usage: chia rpc wallet [OPTIONS] vc_mint [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -| :------------- | :----- | :------- | :----------------------------------------------------------------------------------- | +|:-------------- |:------ |:-------- |:------------------------------------------------------------------------------------ | | did_id | STRING | True | The ID of the DID that will be minting the VC | | target_address | STRING | False | The address where the VC will be sent upon minting [Default: send to minting wallet] | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -431,20 +431,20 @@ Usage: chia rpc wallet [OPTIONS] vc_spend [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Type | Required | Description | -| :--------------------- | :----- | :------- | :------------------------------------------------------------------------------------------------------------------ | -| vc_id | STRING | True | The launcher ID of the Verifiable Credential to spend | -| new_puzhash | None | False | The puzzle hash where the VC will be sent (can be derived from an XCH address) | +| Parameter | Type | Required | Description | +|:------------------------ |:------ |:-------- |:------------------------------------------------------------------------------------------------------------------- | +| vc_id | STRING | True | The launcher ID of the Verifiable Credential to spend | +| new_puzhash | None | False | The puzzle hash where the VC will be sent (can be derived from an XCH address) | | new_proof_hash | None | False | Can be used to update the vc's proofs -- the new root/proof hash | | provider_inner_puzhash | STRING | False | Can be used to update the vc's proofs -- the proof provider's inner puzzle hash | -| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | -| fee | None | False | An optional blockchain fee, in mojos | +| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | +| fee | None | False | An optional blockchain fee, in mojos |
Example @@ -579,7 +579,7 @@ Response: } ``` -At this point, the credential has been transferred to the holder. In order for the holder to verify the VC, the holder will need to add the proofs manually to the local DB: +At this point, the credential has been transferred to the holder. At this point, the credential has been transferred to the holder. In order for the holder to verify the VC, the holder will need to add the proofs manually to the local DB: ```json chia rpc wallet vc_add_proofs '{"proofs": {"example_proof_1": "example_value_1", "example_proof_2": "example_value_2"}}' @@ -649,17 +649,17 @@ Usage: chia rpc wallet [OPTIONS] vc_revoke [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Type | Required | Description | -| :------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------ | -| vc_parent_id | STRING | True | The parent ID of the VC coin | -| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | -| fee | INTEGER | False | An optional blockchain fee, in mojos | +| Parameter | Type | Required | Description | +|:-------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------- | +| vc_parent_id | STRING | True | The parent ID of the VC coin | +| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | +| fee | INTEGER | False | An optional blockchain fee, in mojos |
Example @@ -939,7 +939,7 @@ console.log( ); ``` -The script will output the proof hash for the proofs your entered. In this example, the output is: +The script will output the proof hash for the proofs your entered. In this example, the output is: In this example, the output is: `96c9597578333c840f895f30af6d40b9f6c0d69100db1a13ae2e26e4c94acdd3` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md index 705d85d238..38294c098c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md @@ -39,14 +39,14 @@ To run the same command on Windows, you need to escape the quotes with backslash Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------- | :--------- | :------- | :------------------------- | +| Flag | Type | Required | Description | +|:-------- |:---------- |:-------- |:-------------- | | mnemonic | TEXT ARRAY | True | 一个24字助记词，表示为数组 |
@@ -78,16 +78,16 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :--------------- | :----- | :------- | :----------------------------------------------------------------- | -| fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` | -| max_ph_to_search | NUMBER | False | 要搜索的拼图哈希的最大数量[默认：100] | +| Flag | Type | Required | Description | +|:------------------ |:------ |:-------- |:------------------------------------------------------------------ | +| fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` | +| max_ph_to_search | NUMBER | False | 要搜索的拼图哈希的最大数量[默认：100] |
Example @@ -121,7 +121,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -161,14 +161,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :----- | :------- | :----------------------------------------------------------------- | +|:----------- |:------ |:-------- |:------------------------------------------------------------------ | | fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` |
@@ -199,7 +199,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -259,7 +259,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -294,14 +294,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :----- | :------- | :----------------------------------------------------------------- | +|:----------- |:------ |:-------- |:------------------------------------------------------------------ | | fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` | :::warning @@ -346,7 +346,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -381,14 +381,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :----- | :------- | :----------------------------------------------------------------- | +|:----------- |:------ |:-------- |:------------------------------------------------------------------ | | fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` |
@@ -422,7 +422,7 @@ Usage: chia rpc wallet [OPTIONS] get_auto_claim [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -462,7 +462,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -497,7 +497,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -533,7 +533,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -570,14 +570,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----- | :----- | :------- | :--------------------------------------------------- | +|:------ |:------ |:-------- |:---------------------------------------------------- | | height | NUMBER | True | The block height for which to retrieve the timestamp |
@@ -611,14 +611,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----------- | :--------- | :------- | :----------------------------- | +|:------------ |:---------- |:-------- |:------------------------------ | | transactions | TEXT ARRAY | True | A list of transactions to push | --- @@ -632,14 +632,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----------- | :--- | :------- | :------------------------------------- | +|:------------ |:---- |:-------- |:-------------------------------------- | | spend_bundle | TEXT | True | The spend bundle (transaction) to push | --- @@ -653,14 +653,14 @@ Usage: chia rpc wallet [OPTIONS] set_auto_claim [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--------- | :------ | :------- | :----------------------------------------------------------------------- | +|:---------- |:------- |:-------- |:------------------------------------------------------------------------ | | enabled | BOOLEAN | TRUE | Set to `true` to enable auto claim, or `false` to disable it | | tx_fee | NUMBER | TRUE | The default transaction fee to be used for claims, in mojos | | min_amount | NUMBER | TRUE | The minimum value, in mojos, of a claim to be included in the auto claim | @@ -720,14 +720,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----- | :------ | :------- | :----------------------------------------------- | +|:------ |:------- |:-------- |:------------------------------------------------ | | enable | BOOLEAN | False | Set to `true` to enable resync [Default: `true`] |
@@ -760,57 +760,28 @@ Usage: chia rpc wallet [OPTIONS] create_new_wallet [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters (all wallet types): -| Flag | Type | Required | Description | -| :---------- | :----- | :------- | :------------------------------------------------------------------------------------------------------------------------------------ | -| wallet_type | TEXT | True | The type of wallet to create. The type of wallet to create. Must be one of `cat_wallet`, `did_wallet`, `nft_wallet`, or `pool_wallet` | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| Flag | Type | Required | Description | +|:----------- |:------ |:-------- |:--------------------------------------------------------------------------------------------------------------------- | +| wallet_type | STRING | True | The type of wallet to create. Must be one of `cat_wallet`, `did_wallet`, `dao_wallet`, `nft_wallet`, or `pool_wallet` | +| fee | NUMBER | False | An optional blockchain fee, in mojos | `cat_wallet` Parameters: -| Flag | Type | Required | Description | -| :------- | :----- | :------- | :--------------------------------------------------------------------------------------------------------------------- | -| mode | TEXT | True | Must be either `new` of `existing` | -| name | TEXT | False | The name of the wallet to create or modify [Default: `CAT` followed by the beginning of the CAT ID] | -| amount | NUMBER | True\* | \*Required if `mode` is `new`. Specify the value, in mojos, of this wallet | -| asset_id | TEXT | True\* | \*Required if `mode` is `existing`. \*Required if `mode` is `existing`. Specify the `asset_id` of the wallet to update | - -`did_wallet` Parameters: - -| Flag | Type | Required | Description | -| :----------------------- | :--------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| did_type | TEXT | True | Must be either `new` or `recovery`. Must be either `new` or `recovery`. If `recovery`, then each of the following parameters will be ignored | -| backup_dids | TEXT ARRAY | True\* | \*Required if `did_type` is `new`. An array of backup DID IDs to be used for recovery. Must match actual DIDs | -| num_of_backup_ids_needed | NUMBER | True\* | \*Required if `did_type` is `new`. The number of backup DIDs required for recovery. Minimum value is `1`, maximum value is the number of DIDs in `backup_dids` | -| metadata | DICT | False | The metadata of the DID | -| wallet_name | TEXT | False | The name of the DID wallet [Default: None] | -| amount | NUMBER | True\* | \*Required if `did_type` is `new`. Specify the initial value of this wallet, in mojos. Minimum value is `1` | - -Note: Because `backup_dids` is required, you must already have access to a DID in order to run this RPC for a did_wallet. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. - -`nft_wallet` Parameters: - -| Flag | Type | Required | Description | -| :----- | :--- | :------- | :----------------------------------------------------------------- | -| did_id | TEXT | False | Associate a DID with the new NFT wallet | -| name | TEXT | False | The name of the wallet to create or modify [Default: `NFT Wallet`] | - -`pool_wallet` Parameters: - -| Flag | Type | Required | Description | -| :---------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| mode | TEXT | True | Must be either `new` of `recovery`. Must be either `new` of `recovery`. However, `recovery` has not been implemented, so currently (version 1.6) it will automatically fail | -| initial_target_state | TEXT | True | This info should be sent from the daemon. This info should be sent from the daemon. `PoolState` is a type that is serialized to the blockchain to track the state of the user's pool singleton `target_puzzle_hash` is either the pool address, or the self-pooling address that pool rewards will be paid to. `target_puzzle_hash` is NOT the `p2_singleton` puzzle that block rewards are sent to. The `p2_singleton` address is the initial address, and the `target_puzzle_hash` is the final destination. `relative_lock_height` is zero when in `SELF_POOLING` state `target_puzzle_hash` is NOT the `p2_singleton` puzzle that block rewards are sent to. The `p2_singleton` address is the initial address, and the `target_puzzle_hash` is the final destination. `relative_lock_height` is zero when in `SELF_POOLING` state | -| p2_singleton_delayed_ph | TEXT | True\* | \*Required if `mode` is `new`. This is the puzzle hash to which payouts will go | -| p2_singleton_delay_time | INTEGER | False | The time (in seconds) to delay payments [Default: None ] | +| Flag | Type | Required | Description | +|:-------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------------------------- | +| mode | STRING | True | Must be either `new` of `existing` | +| name | STRING | False | The name of the wallet to create or modify [Default: `CAT` followed by the beginning of the CAT ID] | +| amount | NUMBER | True\* | \*Required if `mode` is `new`. Specify the value, in mojos, of this wallet | +| asset_id | STRING | True\* | \*Required if `mode` is `existing`. *Required if `mode` is `existing`. Specify the `asset_id` of the wallet to update |
-Example 1 +Example 1 (CAT wallet with name) Create a new CAT wallet called `test` and send it 100 mojos: @@ -861,7 +832,7 @@ test:
-Example 2 +Example 2 (CAT wallet without name) Create a new CAT wallet without specifying a name: @@ -915,8 +886,21 @@ CAT 348dfae821c76f0a...:
+`did_wallet` Parameters: + +| Flag | Type | Required | Description | +|:---------------------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| did_type | STRING | True | Must be either `new` or `recovery`. Must be either `new` or `recovery`. If `recovery`, then each of the following parameters will be ignored | +| backup_dids | STRING ARRAY | True\* | \*Required if `did_type` is `new`. An array of backup DID IDs to be used for recovery. Must match actual DIDs | +| num_of_backup_ids_needed | NUMBER | True\* | \*Required if `did_type` is `new`. The number of backup DIDs required for recovery. Minimum value is `1`, maximum value is the number of DIDs in `backup_dids` | +| metadata | DICT | False | The metadata of the DID | +| wallet_name | STRING | False | The name of the DID wallet [Default: None] | +| amount | NUMBER | True\* | \*Required if `did_type` is `new`. Specify the initial value of this wallet, in mojos. Minimum value is `1` | + +Note: Because `backup_dids` is required, you must already have access to a DID in order to run this RPC for a did_wallet. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. +
-Example 3 +Example 3 (DID wallet) Create a new DID wallet with one backup DID: @@ -966,8 +950,75 @@ Profile 1:
+`dao_wallet` Parameters: + +| Flag | Type | Required | Description | +|:---------------- |:--------- |:--------- |:---------------------------------------------------------------------------------------------------------------------------- | +| mode | STRING | True | Must be either `new` of `existing` | +| name | STRING | False | A name to give to the DAO new/existing wallet [Default: None] | +| dao_rules | JSON DICT | True\* | \*Required if `mode` is `new`; this is a json dictionary of the new DAO's rules | +| amount_of_cats | NUMBER | False\* | \*Only used if `mode` is `new`; this is the number of DAO CATs (in mojos) to create when initializing the DAO [Default: 0] | +| filter-amount | NUMBER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | +| fee | NUMBER | False\* | \*Required if `mode` is `new`. This is the puzzle hash to which payouts will go | +| fee_for_cat | NUMBER | False\* | \*Only used if `mode` is `new`; this is a blockchain fee to add to the transaction to create the DAO CATs [Default: 0] | +| treasury_id | STRING | True\* | \*Required if `mode` is `existing`. \*Required if `mode` is `existing`. Specify the `asset_id` of the wallet to update | + +Notes: + +- When `mode` is `new`, this RPC has a similar functionality to the [create](/dao-cli/#create) DAO CLI command. +- When `mode` is `existing`, this RPC has a similar functionality to the [add](/dao-cli/#add) DAO CLI command. +
-Example 4 +Example 4 (New DAO wallet) + +Create a new wallet with some basic DAO rules; also mint CATs and include transaction fees: + +```bash +Note: Because backup_dids is required, you must already have access to a DID in order to run this RPC for a did_wallet. If you do not already have a DID, then run the CLI command to create a DID wallet instead. If you do not already have a DID, then run the CLI command to create a DID wallet instead. +``` + is required, you must already have access to a DID in order to run this RPC for a did_wallet. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. + + +As a result, a new treasury will be created, along with a CAT wallet containing 1000 CATs, and a DAO CAT wallet: + +```bash +For this example, we'll use the wallet with ID 7. This wallet is type 6 (CAT): +``` +. This wallet is type 6 (CAT): + + +
+ +
+Example 5 (Join existing DAO) + +To join a DAO, set `mode` to `existing`: + +```bash +This coin is "type": 7, so it is being sent from this wallet. This RPC can be used to claw back this coin as long as it has yet to be spent by the recipient wallet: +``` +, so it is being sent from this wallet. This RPC can be used to claw back this coin as long as it has yet to be spent by the recipient wallet: + + +Your wallet will join the treasury and automatically create the required DAO, CAT, and DAO_CAT wallets without any balance: + +```bash +The type of wallet to create. The type of wallet to create. Must be one of cat_wallet, did_wallet, nft_wallet, or pool_wallet +``` +, did_wallet, nft_wallet, or pool_wallet + + +
+ +`nft_wallet` Parameters: + +| Flag | Type | Required | Description | +|:------ |:------ |:-------- |:------------------------------------------------------------------ | +| did_id | STRING | False | Associate a DID with the new NFT wallet | +| name | STRING | False | The name of the wallet to create or modify [Default: `NFT Wallet`] | + +
+Example 6 (NFT wallet without DID) Create a new NFT wallet that is not associated with a DID: @@ -988,7 +1039,7 @@ Response:
-Example 5 +Example 7 (NFT wallet with DID) Create an NFT wallet that is associated with a DID. First, create the DID: First, create the DID: @@ -1021,6 +1072,15 @@ Response:
+`pool_wallet` Parameters: + +| Flag | Type | Required | Description | +|:------------------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| mode | STRING | True | Must be either `new` of `recovery`. Must be either `new` of `recovery`. However, `recovery` has not been implemented, so currently (version 1.6) it will automatically fail | +| initial_target_state | STRING | True | This info should be sent from the daemon. This info should be sent from the daemon. `PoolState` is a type that is serialized to the blockchain to track the state of the user's pool singleton `target_puzzle_hash` is either the pool address, or the self-pooling address that pool rewards will be paid to. `target_puzzle_hash` is NOT the `p2_singleton` puzzle that block rewards are sent to. The `p2_singleton` address is the initial address, and the `target_puzzle_hash` is the final destination. `relative_lock_height` is zero when in `SELF_POOLING` state `target_puzzle_hash` is NOT the `p2_singleton` puzzle that block rewards are sent to. The `p2_singleton` address is the initial address, and the `target_puzzle_hash` is the final destination. `relative_lock_height` is zero when in `SELF_POOLING` state | +| p2_singleton_delayed_ph | STRING | True\* | \*Required if `mode` is `new`. This is the puzzle hash to which payouts will go | +| p2_singleton_delay_time | INTEGER | False | The time (in seconds) to delay payments [Default: None ] | + --- ### `get_wallets` @@ -1032,36 +1092,36 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :----------- | :------ | :------- | :----------------------------------------------------------------------- | +|:------------ |:------- |:-------- |:------------------------------------------------------------------------ | | include_data | BOOLEAN | False | Set to `true` to include all coin info for this wallet [Default: `true`] | | type | INTEGER | False | The type of wallet to retrieve. See below for valid types | Valid wallet types (the `type` parameter) include the following integers: -| Name | type | -| :--------------- | ---: | -| STANDARD_WALLET | 0 | -| ATOMIC_SWAP | 2 | -| AUTHORIZED_PAYEE | 3 | -| MULTI_SIG | 4 | -| CUSTODY | 5 | -| CAT | 6 | -| RECOVERABLE | 7 | -| DECENTRALIZED_ID | 8 | -| POOLING_WALLET | 9 | -| NFT | 10 | -| DATA_LAYER | 11 | +| Name | type | +|:------------------ | ----:| +| STANDARD_WALLET | 0 | +| ATOMIC_SWAP | 2 | +| AUTHORIZED_PAYEE | 3 | +| MULTI_SIG | 4 | +| CUSTODY | 5 | +| CAT | 6 | +| RECOVERABLE | 7 | +| DECENTRALIZED_ID | 8 | +| POOLING_WALLET | 9 | +| NFT | 10 | +| DATA_LAYER | 11 | | DATA_LAYER_OFFER | 12 | -| VC | 13 | +| VC | 13 | -More types may be added in the future. See [wallet_types.py](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/util/wallet_types.py) for an up-to-date list of valid types. +More types may be added in the future. More types may be added in the future. See [wallet_types.py](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/util/wallet_types.py) for an up-to-date list of valid types.
Example 1 @@ -1138,24 +1198,24 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------- | :----------- | :------- | :----------------------------------------------------------------------------------------- | -| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | -| additions | TEXT ARRAY | True | A list of puzzle hashes and amounts to be included | +| Flag | Type | Required | Description | +|:---------------------- |:------------ |:-------- |:------------------------------------------------------------------------------------------ | +| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | +| additions | TEXT ARRAY | True | A list of puzzle hashes and amounts to be included | | min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | | max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | | exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| coins | TEXT ARRAY | True | A list of coins to include | -| exclude_coins | TEXT ARRAY | True | A list of coins to exclude | -| coin_announcements | TEXT ARRAY | False | A list of coin announcements, which includes `coin_id`, `message`, and `morph_bytes` | -| puzzle_announcements | TEXT ARRAY | False | A list of puzzle announcements, which includes `puzzle_hash`, `message`, and `morph_bytes` | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| coins | TEXT ARRAY | True | A list of coins to include | +| exclude_coins | TEXT ARRAY | True | A list of coins to exclude | +| coin_announcements | TEXT ARRAY | False | A list of coin announcements, which includes `coin_id`, `message`, and `morph_bytes` | +| puzzle_announcements | TEXT ARRAY | False | A list of puzzle announcements, which includes `puzzle_hash`, `message`, and `morph_bytes` | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -1168,14 +1228,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :------------------------------------------------------------------------------------------------------------------------- | +|:--------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------- | | ids | False | Set to delete notifications only from the specified IDs. \[Default: delete from all IDs\] \[Default: delete from all IDs\] |
@@ -1206,14 +1266,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------------------------------- | +|:--------- |:------ |:-------- |:------------------------------------------------------ | | wallet_id | NUMBER | True | The ID of the wallet from which to delete transactions |
@@ -1244,14 +1304,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :----- | :------- | :----------------------------------------------------------------------------------------- | +|:----- |:------ |:-------- |:------------------------------------------------------------------------------------------ | | index | NUMBER | True | The new derivation index. The new derivation index. Must be larger than the previous index | Note: The derivation index is the minimum number of addresses the wallet will examine. It's not possible to decrease this number. It's not possible to decrease this number. @@ -1285,7 +1345,7 @@ Usage: chia rpc wallet [OPTIONS] get_coin_records [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1339,17 +1399,17 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------ | :--------- | :------- | :-------------------------------------------------- | -| names | TEXT ARRAY | True | A list of coin names from which to retrieve records | -| start_height | NUMBER | False | The block height at which to start the query | -| end_height | NUMBER | False | The block height at which to end the query | +| Flag | Type | Required | Description | +|:--------------------- |:---------- |:-------- |:--------------------------------------------------- | +| names | TEXT ARRAY | True | A list of coin names from which to retrieve records | +| start_height | NUMBER | False | The block height at which to start the query | +| end_height | NUMBER | False | The block height at which to end the query | | include_spent_coins | BOOLEAN | False | Include spent coins in the result [Default: false] |
@@ -1393,7 +1453,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1428,7 +1488,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1467,14 +1527,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :------ | :------- | :----------------------------------------------------------------------------- | +|:----------- |:------- |:-------- |:------------------------------------------------------------------------------ | | wallet_id | TEXT | True | The ID of the wallet from which to obtain the next address | | new_address | BOOLEAN | True | If `true`, then create a new address, else display the latest existing address | @@ -1508,14 +1568,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -| :-------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------- | +|:--------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | | ids | False | Set to receive notifications only from the specified IDs. \[Default: receive from all IDs\] \[Default: receive from all IDs\] | | start | False | The number corresponding to the first notification to list. \[Default: the first notification\] \[Default: the first notification\] | | end | False | The number corresponding to the last notification to list. \[Default: the last notification\] \[Default: the last notification\] | @@ -1557,19 +1617,19 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :-------------------- | :----------- | :------- | :------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the wallet from which to display coins | +| Flag | Type | Required | Description | +|:----------------------- |:------------ |:-------- |:-------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the wallet from which to display coins | | min_coin_amount | NUMBER | False | The smallest coin to be selected in this query [Default: No minimum] | | max_coin_amount | NUMBER | False | The largest coin to be selected in this query [Default: No maximum] | | excluded_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| excluded_coins | TEXT ARRAY | False | A list of coins to exclude | +| excluded_coins | TEXT ARRAY | False | A list of coins to exclude | | excluded_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude |
@@ -1617,15 +1677,26 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------- | :--- | :------- | :--------------------------------------------------------------------------------------------------------------------------- | -| transaction_id | TEXT | True | The ID of the transaction to obtain. This is listed as `name` in the output of the [get_transactions](#get_transactions) RPC | +| Flag | Type | Required | Description | +|:-------------- |:---- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| transaction_id | TEXT | True | The ID of the transaction to obtain. The ID of the transaction to obtain. This is listed as `name` in the output of the [get_transactions](#get_transactions) RPC | + +
+Notes about transactions +The transaction history is not deterministic due to heuristics we use to counter privacy features of the blockchain. This means, a couple of details cannot be fetched fully: +- The transaction IDs can and will change if you resync the wallet +- Transactions of assets other than xch (cat, nft, ...) which include a fee will cause a second fee-transaction in the xch currency wallet (wallet 1) +- Offers are split into multiple transactions on the corresponding wallets +- Transactions of one Offer do not share the same id`s. To match them up, it is best to keep the offer files +- The transaction time is a rough estimate. When an offer is accepted, the individual transactions of one offer can/will have slightly differing transaction times +- For your offers which were accepted by a 3rd Party , the incoming coins are beeing marked as incoming transaction, not as incoming trade +- When cancelling offers, the cancellation Transactions are beeing shown as transaction, not as trade For accurate records, you should keep a local record of transactions (TXs) and the Offer files made.
Example @@ -1687,14 +1758,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--------- | :------ | :------- | :------------------------------------------------------------------ | +|:---------- |:------- |:-------- |:------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the wallet from which to obtain transactions | | start | NUMBER | False | The sequence number of the first transaction to show [Default: 0] | | end | NUMBER | False | The sequence number of the last transaction to show [Default: 50] | @@ -1702,7 +1773,19 @@ Request Parameters: | reverse | BOOLEAN | False | Set to `true` to sort the results in reverse order [Default: false] | | to_address | STRING | False | Only include transactions with this `to_address` [Default: None] | -Note: By default, the function lists the oldest transactions first. This is recommended for building a transaction history due to pagination. If reverse is set to true, it lists the newest transactions first. This is most useful for fetching recent transactions. +
+Notes about transactions +By default, the function lists the oldest transactions first. This is recommended for building a transaction history due to pagination. If reverse is set to true, it lists the newest transactions first. This is most useful for fetching recent transactions. + +The transaction history is not deterministic due to heuristics we use to counter privacy features of the blockchain. This means, a couple of details cannot be fetched fully: + +- The transaction IDs can and will change if you resync the wallet +- Transactions of assets other than xch (cat, nft, ...) which include a fee will cause a second fee-transaction in the xch currency wallet (wallet 1) +- Offers are split into multiple transactions on the corresponding wallets +- Transactions of one Offer do not share the same id`s. To match them up, it is best to keep the offer files +- The transaction time is a rough estimate. When an offer is accepted, the individual transactions of one offer can/will have slightly differing transaction times +- For your offers which were accepted by a 3rd Party , the incoming coins are beeing marked as incoming transaction, not as incoming trade +- When cancelling offers, the cancellation Transactions are beeing shown as transaction, not as trade For accurate records, you should keep a local record of transactions (TXs) and the Offer files made.
Example 1: List a single XCH transaction @@ -1766,7 +1849,7 @@ Response: } ``` -In this case, we are interested in the `Chia Wallet`, of type `0`. This has an `id` of `1`. +In this case, we are interested in the `Chia Wallet`, of type `0`. This has an `id` of `1`. This has an `id` of `1`. Next, list only the transaction from that wallet with an index of `3`: @@ -1938,14 +2021,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :--- | :------- | :------------------------------------------------------- | +|:--------- |:---- |:-------- |:-------------------------------------------------------- | | wallet_id | TEXT | True | The wallet ID from which to obtain the transaction count |
@@ -1978,14 +2061,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -| :------------- | :----- | :------- | :------------------------------------------------------- | +|:-------------- |:------ |:-------- |:-------------------------------------------------------- | | transaction_id | STRING | True | The ID of the transaction for which to retrieve the memo |
@@ -2021,14 +2104,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------------------------------------- | +|:--------- |:------ |:-------- |:------------------------------------------------------------ | | wallet_id | NUMBER | True | The Wallet ID of the wallet from which to obtain the balance |
@@ -2071,14 +2154,14 @@ Functionality: Obtain the balance (and related info) from one or more wallets Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--------- | :--- | :------- | :----------------------------------------------------------------------------------------- | +|:---------- |:---- |:-------- |:------------------------------------------------------------------------------------------ | | wallet_ids | LIST | False | A list of Wallet IDs from which to obtain the balance [Default: list info for all wallets] |
@@ -2137,20 +2220,20 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :-------------------- | :----------- | :------- | :------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the wallet from which to select coins | -| amount | NUMBER | True | The number of mojos to select | +| Flag | Type | Required | Description | +|:----------------------- |:------------ |:-------- |:-------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the wallet from which to select coins | +| amount | NUMBER | True | The number of mojos to select | | min_coin_amount | NUMBER | False | The smallest coin to be selected in this query [Default: No minimum] | | max_coin_amount | NUMBER | False | The largest coin to be selected in this query [Default: No maximum] | | excluded_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| excluded_coins | TEXT ARRAY | False | A list of coins to exclude | +| excluded_coins | TEXT ARRAY | False | A list of coins to exclude |
Example 1 @@ -2206,14 +2289,14 @@ Request failed: {'error': 'Transaction for 1000 is greater than spendable balanc Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -| :-------- | :--------- | :------- | :-------------------------------------------------- | +|:--------- |:---------- |:-------- |:--------------------------------------------------- | | target | HEX STRING | True | The puzzle hash you would like to send a message to | | message | HEX STRING | True | The hex-encoded message you would like to send | | amount | NUMBER | True | The number of mojos to include with this message | @@ -2506,24 +2589,24 @@ This command will create a Message Coin on the blockchain. This command will cre Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | -| address | TEXT | True | The destination address | -| amount | NUMBER | True | The number of mojos to send | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | +| Flag | Type | Required | Description | +|:---------------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | +| address | TEXT | True | The destination address | +| amount | NUMBER | True | The number of mojos to send | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | | min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | | max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | | exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | | exclude_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -2605,14 +2688,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :--------- | :------- | :--------------------------------------------------------- | +|:--------- |:---------- |:-------- |:---------------------------------------------------------- | | wallet_id | TEXT | True | The wallet ID for the origin of the transaction | | address | TEXT | True | The destination address | | amount | NUMBER | True | The number of mojos to send | @@ -2631,14 +2714,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -| :-------- | :----- | :------- | :---------------------------------------------------------------------------------------------------- | +|:--------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------- | | address | STRING | True | The address to use for signing. The address to use for signing. Must possess the key for this address | | message | STRING | True | The message to include with the signature | @@ -2672,14 +2755,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -| :-------- | :----- | :------- | :------------------------------------------------------------------------------------------------------ | +|:--------- |:------ |:-------- |:------------------------------------------------------------------------------------------------------- | | id | STRING | True | The DID or NFT ID to use for signing. Must possess the key for this ID Must possess the key for this ID | | message | STRING | True | The message to include with the signature | @@ -2713,24 +2796,24 @@ Usage: chia rpc wallet [OPTIONS] spend_clawback_coins [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | +|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :--------- | :----------- | :------- | :----------------------------------------------------------------------------------------------------------------- | -| coin_ids | STRING ARRAY | True | List of coin IDs to be spent | +| Flag | Type | Required | Description | +|:---------- |:------------ |:-------- |:-------------------------------------------------------------------------------------------------------------------- | +| coin_ids | STRING ARRAY | True | List of coin IDs to be spent | | batch_size | NUMBER | False | The number of coins to spend per bundle, [Default: `batch_size` obtainable from [get_auto_claim](#get_auto_claim)] | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos | When examing the on-chain metadata for a transaction, a coin with `"type": 6` is a clawback coin to be received by this wallet, and a coin with `"type": 7` is a clawback coin sent from this wallet.
Example -First, list a clawback transaction. For this example, we will specify the `to_address`. +First, list a clawback transaction. First, list a clawback transaction. For this example, we will specify the `to_address`. Alternatively, you could search for coins with `"type": 6` (receive) or `"type": 7` (send), and `"spent": false`. @@ -2969,21 +3052,21 @@ chia rpc wallet get_transaction '{"transaction_id": "66f7fd75bb4a2408d219d89f858 Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :----------- | :--- | :------- | :------------------------------------------------------------------------------------------------ | +| Flag | Type | Required | Description | +|:------------ |:---- |:-------- |:--------------------------------------------------------------------------------------------------- | | signing_mode | TEXT | False | Specify the type of signature to verify \[Default: BLS with hex input\] (see below for more info) | -| pubkey | TEXT | True | The public key of the signature to verify | -| message | TEXT | True | The message to verify | -| signature | TEXT | True | The signature to verify | -| address | TEXT | True | The address, which must be derived from `pubkey` | +| pubkey | TEXT | True | The public key of the signature to verify | +| message | TEXT | True | The message to verify | +| signature | TEXT | True | The signature to verify | +| address | TEXT | True | The address, which must be derived from `pubkey` | -The signing mode strings are [stored in an enum](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/types/signing_mode.py). As of Chia 2.0.0, valid signing mode strings include: +The signing mode strings are [stored in an enum](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/types/signing_mode.py). As of Chia 2.0.0, valid signing mode strings include: As of Chia 2.0.0, valid signing mode strings include: - `BLS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_AUG:hexinput_` - Default signing mode @@ -2995,6 +3078,9 @@ The signing mode strings are [stored in an enum](https://github.com/Chia-Network - Same as above, but uses UTF-8 instead of hex - `BLS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_AUG:CHIP-0002_` - [CHIP-0002](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0002.md) signs the result of `sha256tree(cons("Chia Signed Message", message))` using the BLS message augmentation scheme +- `BLS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_AUG:CHIP-0002_P2_DELEGATED_PUZZLE` + - Uses p2_delegated_puzzle + - Supports signatures generated from Tangem cards --- @@ -3009,14 +3095,14 @@ Usage: chia rpc wallet [OPTIONS] cancel_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:-------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | secure | BOOLEAN | True | Set to `true` to cancel on the blockchain by spending the coin(s) being offered; set to `false` to cancel in the wallet only. If `false`, the offer could still be taken if it has been shared If `false`, the offer could still be taken if it has been shared | | trade_id | TEXT | True | The ID of the offer to cancel | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -3049,14 +3135,14 @@ Usage: chia rpc wallet [OPTIONS] cancel_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:---------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | secure | BOOLEAN | True | Set to `true` to cancel on the blockchain by spending the coin(s) being offered; set to `false` to cancel in the wallet only. If `false`, the offer could still be taken if it has been shared If `false`, the offer could still be taken if it has been shared | | batch_fee | NUMBER | False | The fee, in mojos, to add to each batch cancellation [Default: 0] | | batch_size | NUMBER | False | The number of offers to cancel in each batch [Default: 5] | @@ -3091,14 +3177,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :--- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:-------- |:---- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | asset_id | TEXT | True | The ID of the CAT whose name you would like to retrieve. The ID of the CAT whose name you would like to retrieve. This CAT must be listed in your `DEFAULT_CATS`, ie the CATs your wallet recognizes |
@@ -3131,14 +3217,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------------------------------------- | +|:--------- |:------ |:-------- |:------------------------------------------------------------ | | wallet_id | NUMBER | True | The wallet ID of the CAT whose ID you would like to retrieve |
@@ -3171,14 +3257,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :------------------------------------------------------------- | +|:--------- |:------ |:-------- |:-------------------------------------------------------------- | | wallet_id | NUMBER | True | The wallet ID of the CAT whose name you would like to retrieve |
@@ -3211,14 +3297,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :------------------------------------------------------- | +|:--------- |:------ |:-------- |:-------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet whose name you would like to change | | name | TEXT | True | The new name for the wallet | @@ -3251,29 +3337,29 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | -| additions | TEXT ARRAY | True\* | \*Must include either `additions` or `amount`. A list of puzzle hashes and amounts to be included | -| amount | NUMBER | True\* | \*Must include either `additions` or `amount`. The number of mojos to send | -| inner_address | TEXT | True | The destination address | -| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | -| coins | TEXT ARRAY | False | A list of coins to include in the spend | -| min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | -| max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | -| exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| exclude_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| extra_delta | TEXT | False\* | The CAT's `extra_delta` parameter; \*If specified, then `tail_reveal` and `tail_solution` must also be specified | -| tail_reveal | TEXT | False\* | The CAT's `tail_reveal` parameter; \*If specified, then `extra_delta` and `tail_solution` must also be specified | -| tail_solution | TEXT | False\* | The CAT's `tail_solution` parameter; \*If specified, then `extra_delta` and `tail_reveal` must also be specified | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| Flag | Type | Required | Description | +|:---------------------- |:------------ |:--------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | +| additions | TEXT ARRAY | True\* | \*Must include either `additions` or `amount`. A list of puzzle hashes and amounts to be included | +| amount | NUMBER | True\* | \*Must include either `additions` or `amount`. The number of mojos to send | +| inner_address | TEXT | True | The destination address | +| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | +| coins | TEXT ARRAY | False | A list of coins to include in the spend | +| min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | +| max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | +| exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | +| exclude_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| extra_delta | TEXT | False\* | The CAT's `extra_delta` parameter; \*If specified, then `tail_reveal` and `tail_solution` must also be specified | +| tail_reveal | TEXT | False\* | The CAT's `tail_reveal` parameter; \*If specified, then `extra_delta` and `tail_solution` must also be specified | +| tail_solution | TEXT | False\* | The CAT's `tail_solution` parameter; \*If specified, then `extra_delta` and `tail_reveal` must also be specified | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -3374,14 +3460,14 @@ Usage: chia rpc wallet [OPTIONS] check_offer_validity [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---- | :--- | :------- | :--------------------------------- | +|:----- |:---- |:-------- |:---------------------------------- | | offer | TEXT | True | The contents of the offer to check |
@@ -3413,22 +3499,22 @@ Usage: chia rpc wallet [OPTIONS] create_offer_for_ids [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :-------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| offer | TEXT | True | The offer to create | -| validate_only | BOOLEAN | False | Only validate the offer instead of creating it [Default: false] | -| driver_dict | DICT | True | A dictionary of keys and values associated with the offer | +| Flag | Type | Required | Description | +|:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| offer | TEXT | True | The offer to create | +| validate_only | BOOLEAN | False | Only validate the offer instead of creating it [Default: false] | +| driver_dict | DICT | True | A dictionary of keys and values associated with the offer | | min_coin_amount | NUMBER | False | The minimum coin amount to select for the offer [Default: none] | | max_coin_amount | NUMBER | False | The maximum coin amount to select for the offer [Default: none] | -| solver | TEXT | False | A marshalled solver | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| solver | TEXT | False | A marshalled solver | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | --- @@ -3441,22 +3527,22 @@ Usage: chia rpc wallet [OPTIONS] get_all_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------- | :------ | :------- | :---------------------------------------------------------------------------- | -| start | NUMBER | False | The sequence number of the first offer to show [Default: 0] | -| end | NUMBER | False | The sequence number of the last offer to show [Default: 10] | +| Flag | Type | Required | Description | +|:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------- | +| start | NUMBER | False | The sequence number of the first offer to show [Default: 0] | +| end | NUMBER | False | The sequence number of the last offer to show [Default: 10] | | exclude_my_offers | BOOLEAN | False | Set to `true` to exclude offers you originated [Default: false] | | exclude_taken_offers | BOOLEAN | False | Set to `true` to exclude offers that have already been taken [Default: false] | -| include_completed | BOOLEAN | False | Set to `true` to include offers that have been taken [Default: false] | -| sort_key | NUMBER | False | Specify the key for sorting [Default: None] | -| reverse | BOOLEAN | False | Set to `true` to sort the results in reverse order [Default: false] | -| file_contents | BOOLEAN | False | Set to `true` to display the contents of each offer [Default: false] | +| include_completed | BOOLEAN | False | Set to `true` to include offers that have been taken [Default: false] | +| sort_key | NUMBER | False | Specify the key for sorting [Default: None] | +| reverse | BOOLEAN | False | Set to `true` to sort the results in reverse order [Default: false] | +| file_contents | BOOLEAN | False | Set to `true` to display the contents of each offer [Default: false] |
Example @@ -3525,7 +3611,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -3583,14 +3669,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------ | :--- | :------- | :------------------------------------------------------------------------------------------------------------------------------- | +|:------------- |:---- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------- | | trade_id | TEXT | True | The offer's ID | | file_contents | TEXT | False | The contents of the offer. The contents of the offer. Required if the offer's info is not stored in the database for this wallet | @@ -3665,7 +3751,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -3702,14 +3788,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer_summary [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------- | :------ | :------- | :---------------------------------------------------------- | +|:-------- |:------- |:-------- |:----------------------------------------------------------- | | offer | TEXT | True | The offer for which to retrieve a summary | | advanced | BOOLEAN | False | Set to `true` to show a detailed summary [Default: `false`] | @@ -3756,7 +3842,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -3791,20 +3877,20 @@ Usage: chia rpc wallet [OPTIONS] take_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :-------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| offer | TEXT | True | The offer to create | +| Flag | Type | Required | Description | +|:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| offer | TEXT | True | The offer to create | | min_coin_amount | NUMBER | False | The minimum coin amount to select for taking the offer [Default: none] | | max_coin_amount | NUMBER | False | The maximum coin amount to select for taking the offer [Default: none] | -| solver | TEXT | False | A marshalled solver | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| solver | TEXT | False | A marshalled solver | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -3899,17 +3985,17 @@ See our [NFT RPC](/nft-rpc) page. Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :--------------- | :----- | :------- | :-------------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The Wallet ID to which to absorb funds (must be of type `POOLING_WALLET`) | +| Flag | Type | Required | Description | +|:------------------ |:------ |:-------- |:--------------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The Wallet ID to which to absorb funds (must be of type `POOLING_WALLET`) | | max_spends_in_tx | NUMBER | False | The maximum number of reward transactions to roll into the absorb transaction [Default: no maximum] | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos | :::note @@ -3928,19 +4014,19 @@ This RPC will only succeed if the wallet has accumulated unspent coinbase reward Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -| :------------------- | :----- | :------- | :--------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The Wallet ID to use to join the pool (must be of type `POOLING_WALLET`) | -| target_puzzlehash | TEXT | True | This is the target of where rewards will be sent to from the singleton. Controlled by the pool | -| pool_url | TEXT | True | The URL of the pool to join | +| Flag | Type | Required | Description | +|:---------------------- |:------ |:-------- |:---------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The Wallet ID to use to join the pool (must be of type `POOLING_WALLET`) | +| target_puzzlehash | TEXT | True | This is the target of where rewards will be sent to from the singleton. Controlled by the pool | +| pool_url | TEXT | True | The URL of the pool to join | | relative_lock_height | NUMBER | True | The number of blocks required to wait when attempting to leave the pool | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos |
Example @@ -4078,14 +4164,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :----------------------------------------------------------------------- | +|:--------- |:------ |:-------- |:------------------------------------------------------------------------ | | wallet_id | NUMBER | True | The Wallet ID to use for self-pooling (must be of type `POOLING_WALLET`) | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -4231,14 +4317,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :-------- | :----- | :------- | :------------------------------------------------------------------------------ | +|:--------- |:------ |:-------- |:------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID for which to obtain the status (must be of type `POOLING_WALLET`) |
@@ -4293,14 +4379,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :--- | :----- | :------- | :-------------------------------------- | +|:---- |:------ |:-------- |:--------------------------------------- | | root | TEXT | True | The root hash of an existing data store | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -4445,14 +4531,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :----- | :------- | :------------------------------------ | +|:------- |:------ |:-------- |:------------------------------------- | | coin_id | TEXT | True | The `coin_id` of the mirror to delete | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -4530,14 +4616,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :--- | :------- | :-------------------------------------- | +|:----------- |:---- |:-------- |:--------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet |
@@ -4577,14 +4663,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------- | :----- | :------- | :----------------------------------------------------------- | +|:-------------- |:------ |:-------- |:------------------------------------------------------------ | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | min_generation | NUMBER | False | The first generation of singleton to show [Default: none] | | max_generation | NUMBER | False | The last generation of the singleton to show [Default: none] | @@ -4651,14 +4737,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------------- | :------ | :------- | :----------------------------------------------------- | +|:-------------- |:------- |:-------- |:------------------------------------------------------ | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | only_confirmed | BOOLEAN | False | Only show the latest confirmed record [Default: false] | @@ -4705,14 +4791,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :--------- | :------- | :------------------------------------------------------------------------------------------------------------------------------ | +|:----------- |:---------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | urls | TEXT ARRAY | True | A list of URLs to be used for the mirror | | amount | NUMBER | True | The value of the mirror (in mojos) to spend to create the mirror. In theory, mirrors with a higher `amount` will be prioritized | @@ -4799,7 +4885,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -4866,14 +4952,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :--- | :------- | :-------------------------------------- | +|:----------- |:---- |:-------- |:--------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | root | TEXT | True | The root hash of an existing data store | @@ -4922,14 +5008,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :--- | :------- | :-------------------------------------- | +|:----------- |:---- |:-------- |:--------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet |
@@ -4960,14 +5046,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :--- | :------- | :-------------------------------------- | +|:----------- |:---- |:-------- |:--------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet |
@@ -4998,14 +5084,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :------ | :--------- | :------- | :------------------------------------------ | +|:------- |:---------- |:-------- |:------------------------------------------- | | updates | TEXT ARRAY | True | A list of launcher IDs and hashes to update | --- @@ -5019,14 +5105,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | +|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -| :---------- | :----- | :------- | :-------------------------------------- | +|:----------- |:------ |:-------- |:--------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | new_root | TEXT | True | The new root hash of the data store | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -5116,7 +5202,7 @@ Note: Inherited from RPC Server Request Parameters: | Flag | Type | Required | Description | -| :------ | :--- | :------- | :--------------------------------------------------------------- | +|:------- |:---- |:-------- |:---------------------------------------------------------------- | | node_id | TEXT | True | The hex ID of the node to close, obtainable from get_connections |
@@ -5339,7 +5425,7 @@ Note: Inherited from RPC Server Request Parameters: | Flag | Type | Required | Description | -| :--- | :------ | :------- | :--------------------------------------------------- | +|:---- |:------- |:-------- |:---------------------------------------------------- | | host | TEXT | True | The IP or URL of the node to connect to | | port | INTEGER | True | The port through which to connect to the remote node | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/check-if-things-are-working.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/check-if-things-are-working.md index 2a810391ce..662831f0f4 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/check-if-things-are-working.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/check-if-things-are-working.md @@ -57,14 +57,14 @@ logging: &id001 log_stdout: false ``` -You can run `grep` ([Linux](https://man7.org/linux/man-pages/man1/grep.1.html), [macOS](https://ss64.com/osx/grep.html)) or `Select-String` ([Windows Powershell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/select-string?view=powershell-7.4)) to search through your logs for relevant information. +You can run `grep` ([Linux](https://man7.org/linux/man-pages/man1/grep.1.html), [macOS](https://ss64.com/osx/grep.html)) or `Select-String` ([Windows](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/select-string?view=powershell-7.1)) to search through your logs for relevant information. # Is It Working? If you want to quickly find errors, run this: - Linux/macOS: `cat ~/.chia/mainnet/log/debug.log | grep -i 'error'` -- Windows Powershell: `Get-Content -Path "~\.chia\mainnet\log\debug.log" | Select-String -Pattern "error"` +- Windows: `Get-Content -Path "~\.chia\mainnet\log\debug.log" | Select-String -Pattern "error"` ## Harvester @@ -74,7 +74,7 @@ Here are some commands you can use to examine `debug.log` for problems. - Linux/macOS: - `tail ~/.chia/mainnet/log/debug.log | grep eligible` -- Windows Powershell: +- Windows: - `Select-String -Path "~\.chia\mainnet\log\debug*" -Pattern "eligible"` - `Select-String -Path "~\.chia\mainnet\log\debug*" -Pattern "Found [^0] proof"` - `Select-String -Path "~\.chia\mainnet\log\debug*" -Pattern "Farmed unfinished_block"` @@ -95,5 +95,5 @@ Block Validation Time - `grep -o "Block validation time: .* seconds" .chia/mainnet/log/debug.log |sort -rV | head -n 10` - For a fancy grep `apt install st-console` then run: - `grep "Block validation time:" ~/.chia/mainnet/log/debug.log* | awk '{print $8}' | st-console --summary -N` -- Windows Powershell: - - `Select-String -Path "~\.chia\mainnet\log\debug.log" -Pattern "Block validation time:" | Select-Object -Last 10` (change 10 to the number of lines you wish to return) +- Windows: + - `Select-String -Path "~\.chia\mainnet\log\debug*" -Pattern "Block validation time:"` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/locating-keys.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/locating-keys.md new file mode 100644 index 0000000000..8e0429786b --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/locating-keys.md @@ -0,0 +1,97 @@ +--- +title: Locating Keys +slug: /troubleshooting/locating-keys +--- + +import WalletKeyDetails from '@site/static/img/troubleshooting/wallet_key_details.png'; +import WalletKeysOverview from '@site/static/img/troubleshooting/wallet_keys_overview.png'; +import WalletLogout from '@site/static/img/troubleshooting/wallet_logout.png'; + +This doc assumes you have chia installed and will overview both the CLI and GUI methods of identifying various keys.\ +Please refer to the [Installation page](/installation) if you do not have chia installed. + +## Keys Overview + +The main keys utilized in chia are: + +1. **Public Key** - also known as the master public key, this key is used with the [Chia faucet](https://faucet.chia.net/) and as an observer only view for funds in the wallet. +2. **Farmer Public Key** - this key is used to generate plots and is a public key. If using a plotting service they will request this key and also a pool contract address which is listed on the pool tab of the gui, detailed instructions can be found [here](/plotting-how-to#pool-contract-address) +3. **Pool Public Key** - this is the key that was used for OG plots which cannot connect to pools. It is recommended to create plotNFT plots (portable plots) and use the pool contract address as outlined [here](/plotting-how-to#pool-contract-address) +4. **Secret Key** - also known as the master private key, this key should **NEVER** be shared with anyone as it can give access to spend funds from your wallet. Always be mindful when clicking the reveal button and recognize that this keyset is generally not needed for any manual entry. +5. **Seed Phrase** - also known as the mnemonic phrase, this key should **NEVER** be shared with anyone as it gives full access to your wallet. This should be backed up in a safe location and never entered into any manual entry field unless you are importing your keys to a new wallet. +6. **Farmer Private Key** - this key should **NEVER** be shared with anyone as it is used to sign farmed blocks. Always be mindful when clicking the reveal button and recognize that this keyset is generally not needed for any manual entry. + +## GUI + +There are a series of different keys that your chia client uses, follow the below steps to view all of these keys but always be mindful with whom you share them. + +:::warning +Never share your private / secret keys or mnemonics with anyone. These give access to spend funds from your wallet. +::: + +### Locating Keys in the GUI + +1. In the top right corner select logout: + +
+ Logout of the Chia wallet +
+
+ +2. Using the desired keys menu, select details: + +
+ Select Details for a Chia keyset +
+
+ +3. View and copy the needed keyset: + +
+ Chia keys detail screen +
+
+ +:::note +For more security best practices please review the [Securing Your Chia – How to Be a Hard Target](https://www.chia.net/2021/05/28/securing-your-chia-how-to-be-a-hard-target/) blog article. +::: + +## CLI + +There are a series of different keys that your chia client uses, follow the below steps to view all of these keys but always be mindful with whom you share them. + +:::warning +**NEVER** share your private / secret keys or mnemonics with anyone. These give access to spend funds from your wallet. +::: + +### Locating Keys in the CLI + +In order to view your keys from the cli, run `chia keys show`, optionally including the `-f ` flag to show only the info for the key you just generated: + +1. From terminal (mac/linux) or powershell (windows) run `chia keys show`: + +```bash +chia keys show +``` + +:::warning +`chia keys show --show-mnemonic-seed`\ +displays the _Master Private Key, Farmer Private Key, and Seed Phrase / Mnemonic_ **NEVER** share these with anyone. +::: + +2. View and copy the needed keyset: + +```bash +Showing all public keys derived from your master seed and private key: + +Label: Demo Wallet +Fingerprint: 2281896037 +Master public key (m): 96ce91d974daa0990e6681ac2de3e3f49142f6b655a081817832265c143e658a6e60a5dec856f292f45fe2d04c7856f6 +Farmer public key (m/12381/8444/0/0): a9e366b26f155491af9a903c0ed9717bfd09a71cbe283eeda825128fd7c6b9ac60e1608f9f008adcfbf66e233d5b4ce8 +Pool public key (m/12381/8444/1/0): 9566fa434f342dd5f9380a6bfc59dd7d1abd22869a425a8ca09cf27200eaa6aad5bc8fc00db90af832eb8028b0c6e3f0 +First wallet address: xch1kr3zf7dqw5q953ex6zt33lndj90q0zlh68404tsntnljthnwqs2qvjmwrg +``` + +:::note +If you run into any issues or have followup questions please join our [discord server](https://discord.gg/chia) and ask in the #support channel. +::: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md index 977abcbb44..ef0358a650 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md @@ -7,11 +7,11 @@ Chia blockchain nodes consist of several components that each handle different a ## Log file Location: -| OS | Location | -| ------- | ---------------------------------------------------------------------------------- | -| Linux | `~/.chia/mainnet/log/debug.log` | +| OS | Location | +| ------- | ----------------------------------------------------------------------------------------------------------- | +| Linux | `~/.chia/mainnet/log/debug.log` | | Windows | `%systemdrive% %homepath% \.chia\mainnet\debug.log` (`C:\Users\\.chia…`) | -| MacOS | `/Users//.chia/mainnet/log/debug.log` | +| MacOS | `/Users//.chia/mainnet/log/debug.log` | ## Log File Management: @@ -37,17 +37,17 @@ Change the `log_level` to `INFO`, save the file, and restart the node. ## Node Components: -| Component | Function | -| ---------------- | ----------------------------------------------- | -| farmer_server | Signage stuff about signs and things | -| harvester_server | Gathers and shares plot information | -| timelord_server | Manages Verifiable Delay Functions for the node | -| wallet_server | Controls wallet functions | +| Component | Function | +| ---------------------------------------------------------- | ----------------------------------------------- | +| farmer_server | Signage stuff about signs and things | +| harvester_server | Gathers and shares plot information | +| timelord_server | Manages Verifiable Delay Functions for the node | +| wallet_server | Controls wallet functions | | full_node_server | This component manages the node | ## Log Message Format: -| Field | Content | +| Field | 内容 | | ----------------- | -------------------------------- | | Date/time | in ISO format, in local timezone | | Node Component | see the list above | @@ -73,70 +73,70 @@ Another log message you will see is `Updated Wallet peak to height x, weight y` ## Other Normal Log Messages: -| Component | Message | Direction | Destination | Cross component | Comment | -| ----------------- | ------------------------------------------------ | --------- | ----------- | -------------------- | ------- | -| mempool_manager | add_spendbundle took x seconds | | | | | -| mempool_manager | It took x to pre validate transaction | | | | | -| full_node | Added unfinished_block x, not farmed by us | | | | | -| full_node | Already compactified block: | | | | | -| full_node | Duplicate compact proof. Height: x | | | | -| full_node | Finished signage point x/64: | | | | -| full_node | Scanning the blockchain for uncompact blocks. | | | | -| full_node | Updated peak to height x | | | | | -| full_node_server | new_compact_vdf | to/from | peer | | | -| full_node_server | new_peak | to/from | peer | | | -| full_node_server | new_peak_timelord | to | localhost | from timelord_server | | -| full_node_server | new_peak_wallet | to | localhost | from wallet_server | | -| full_node_server | new_signage_point | to | localhost | from farmer_server | | -| full_node_server | new_signage_point_or_end_of_sub_slot | to/from | peer | | | -| full_node_server | new_transaction | to/from | peer | | | -| full_node_server | new_unfinished_block | to/from | peer | | | -| full_node_server | new_unfinished_block_timelord | to/from | localhost | | | -| full_node_server | request_block | to/from | peer | | | -| full_node_server | request_block_header | from | localhost | to wallet_server | | -| full_node_server | request_compact_vdf | to/from | peer | | | -| full_node_server | request_compact_proof_of_time | to | localhost | from timelord_server | | -| full_node_server | request_signage_point_or_end_of_sub_slot | to/from | peer | | | -| full_node_server | request_transaction | to/from | peer | | | -| full_node_server | request_unfinished_block | to/from | peer | | | -| full_node_server | respond_block | to/from | peer | | | -| full_node_server | respond_compact_vdf | to/from | peer | | | -| full_node_server | respond_signage_point | to/from | peer | | | -| full_node_server | respond_transaction | to/from | peer | | | -| full_node_server | respond_unfinished_block | to/from | peer | | | -| wallet_server | request_block_header | to | localhost | from full_node | | -| wallet_server | respond_block_header | from | localhost | to full_node | | -| wallet_server | new_peak_wallet | from | localhost | to full_node | | -| wallet_blockchain | Updated Wallet peak to height x, weight y | | | | -| timelord_server | new_peak_timelord | from | localhost | to full_node | | -| timelord_server | new_unfinished_block_timelord | from | localhost | to full_node | | -| timelord_launcher | VDF client x: VDF Client: Discriminant = | | | | -| VDF Client | Sending Proof, Sent Proof, Stopped everything! | | | | -| harvester_server | farming_info | to/from | localhost | | | -| harvester_server | new_signage_point_harvester | from | localhost | to farmer_server | | -| harvester | x plots were eligible for farming | | | | -| plot_tools | Loaded a total of x plots of size y in z seconds | | | | -| plot_tools | Searching directories | | | | -| farmer_server | new_signage_point | from | localhost | to full_node | | -| farmer_server | farming_info | from | localhost | to full_node | | -| farmer_server | new_signage_point_harvester | to | localhost | from harvester | | - -| Source | Level | Message | Description | -| ----------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| daemon asyncio | ERROR | Task exception was never retrieved future: ` exception=ValueError('list.remove(x): x not in list')>` | -| full_node asyncio | ERROR | SSL error in data received protocol: `` | -| full_node full_node_server | ERROR | Exception: Failed to fetch block `N` from \{'host': `IP ADDRESS`, 'port': 8444\}, timed out, \{'host': `IP ADDRESS`, 'port': 8444\}. | Peer disconnected, other peer connections will take over | -| full_node full_node_server | ERROR | Exception: ``, closing connection None. | Peer disconnected | -| full_node full_node_server | WARNING | [Errno 32] Broken pipe `IP Address` | Peer disconnected | -| full_node full_node_server | WARNING | Cannot write to closing transport `IP Address` | Peer disconnected | -| harvester src.plotting.plot_tools | WARNING | Not farming plot `plotfilename`. Size is `filesize` GiB, but expected at least: 99.06 GiB. We assume the file is being copied. | Periodic scan for new plots have discovered partial file - OK if you are in the middle of copying a file | -| harvester src.plotting.plot_tools | WARNING | Directory: `Dir1` does not exist. | One of your monitored plot folders is no longer accessible - eg external drive offline - if permanent remove from GUI or `chia plots remove -d ` | -| harvester src.plotting.plot_tools | WARNING | Have multiple copies of the plot `plotfilename`, not adding it. | | -| harvester src.plotting.plot_tools | INFO | Not checking subdirectory `Dir1/directory`, subdirectories not added by default | | -| full_node full_node_server | INFO | Connection closed: `IP Address`, node id: `hex` | Peer disconnected | -| full_node src.full_node.full_node | INFO | ⏲️ Finished signage point `N`/64: `hex` | -| full_node src.full_node.full_node | INFO | Added unfinished_block `hex`, not farmed | -| harvester src.plotting.plot_tools | INFO | Searching directories [`Dir1`,`Dir2`] | | -| harvester src.plotting.plot_tools | INFO | Loaded a total of `N` plots of size `size` TiB, in `time` seconds | | -| harvester src.harvester.harvester | INFO | `X` plots were eligible for farming `hex`... Found `Y` proofs. Time: `Time` s. Total `Z` plots | This is a vital message and should be seen at regular intervals. Note that `Time` is ideally < 1s. If drive is in sleep mode, may show ~10 seconds, and should be prevented | -| wallet src.wallet.wallet_blockchain | INFO | 💰 Updated wallet peak to height `HEIGHT`, weight `WEIGHT`, | | +| Component | Message | Direction | Destination | Cross component | Comment | +| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | ----------------------------------------- | ------- | +| mempool_manager | add_spendbundle took x seconds | | | | | +| mempool_manager | It took x to pre validate transaction | | | | | +| full_node | Added unfinished_block x, not farmed by us | | | | | +| full_node | Already compactified block: | | | | | +| full_node | Duplicate compact proof. Height: x | | | | | +| full_node | Finished signage point x/64: | | | | | +| full_node | Scanning the blockchain for uncompact blocks. | | | | | +| full_node | Updated peak to height x | | | | | +| full_node_server | new_compact_vdf | to/from | peer | | | +| full_node_server | new_peak | to/from | peer | | | +| full_node_server | new_peak_timelord | to | localhost | from timelord_server | | +| full_node_server | new_peak_wallet | to | localhost | from wallet_server | | +| full_node_server | new_signage_point | to | localhost | from farmer_server | | +| full_node_server | new_signage_point_or_end_of_sub_slot | to/from | peer | | | +| full_node_server | new_transaction | to/from | peer | | | +| full_node_server | new_unfinished_block | to/from | peer | | | +| full_node_server | new_unfinished_block_timelord | to/from | localhost | | | +| full_node_server | request_block | to/from | peer | | | +| full_node_server | request_block_header | from | localhost | to wallet_server | | +| full_node_server | request_compact_vdf | to/from | peer | | | +| full_node_server | request_compact_proof_of_time | to | localhost | from timelord_server | | +| full_node_server | request_signage_point_or_end_of_sub_slot | to/from | peer | | | +| full_node_server | request_transaction | to/from | peer | | | +| full_node_server | request_unfinished_block | to/from | peer | | | +| full_node_server | respond_block | to/from | peer | | | +| full_node_server | respond_compact_vdf | to/from | peer | | | +| full_node_server | respond_signage_point | to/from | peer | | | +| full_node_server | respond_transaction | to/from | peer | | | +| full_node_server | respond_unfinished_block | to/from | peer | | | +| wallet_server | request_block_header | to | localhost | from full_node | | +| wallet_server | respond_block_header | from | localhost | to full_node | | +| wallet_server | new_peak_wallet | from | localhost | to full_node | | +| wallet_blockchain | Updated Wallet peak to height x, weight y | | | | | +| timelord_server | new_peak_timelord | from | localhost | to full_node | | +| timelord_server | new_unfinished_block_timelord | from | localhost | to full_node | | +| timelord_launcher | VDF client x: VDF Client: Discriminant = | | | | | +| VDF Client | Sending Proof, Sent Proof, Stopped everything! | | | | | +| harvester_server | farming_info | to/from | localhost | | | +| harvester_server | new_signage_point_harvester | from | localhost | to farmer_server | | +| harvester | x plots were eligible for farming | | | | | +| plot_tools | Loaded a total of x plots of size y in z seconds | | | | | +| plot_tools | Searching directories | | | | | +| farmer_server | new_signage_point | from | localhost | to full_node | | +| farmer_server | farming_info | from | localhost | to full_node | | +| farmer_server | new_signage_point_harvester | to | localhost | from harvester | | + +| Source | Level | Message | Description | +| -------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| daemon asyncio | ERROR | Task exception was never retrieved future: ` exception=ValueError('list.remove(x): x not in list')>` | | +| full_node asyncio | ERROR | SSL error in data received protocol: `` | | +| full_node full_node_server | ERROR | Exception: Failed to fetch block `N` from \{'host': `IP ADDRESS`, 'port': 8444\}, timed out, \{'host': `IP ADDRESS`, 'port': 8444\}. | Peer disconnected, other peer connections will take over | +| full_node full_node_server | ERROR | Exception: ``, closing connection None. | Peer disconnected | +| full_node full_node_server | WARNING | [Errno 32] Broken pipe `IP Address` | Peer disconnected | +| full_node full_node_server | WARNING | Cannot write to closing transport `IP Address` | Peer disconnected | +| harvester src.plotting.plot_tools | WARNING | Not farming plot `plotfilename`. Size is `filesize` GiB, but expected at least: 99.06 GiB. We assume the file is being copied. | Periodic scan for new plots have discovered partial file - OK if you are in the middle of copying a file | +| harvester src.plotting.plot_tools | WARNING | Directory: `Dir1` does not exist. | One of your monitored plot folders is no longer accessible - eg external drive offline - if permanent remove from GUI or `chia plots remove -d ` | +| harvester src.plotting.plot_tools | WARNING | Have multiple copies of the plot `plotfilename`, not adding it. | | +| harvester src.plotting.plot_tools | INFO | Not checking subdirectory `Dir1/directory`, subdirectories not added by default | | +| full_node full_node_server | INFO | Connection closed: `IP Address`, node id: `hex` | Peer disconnected | +| full_node src.full_node.full_node | INFO | ⏲️ Finished signage point `N`/64: `hex` | | +| full_node src.full_node.full_node | INFO | Added unfinished_block `hex`, not farmed | | +| harvester src.plotting.plot_tools | INFO | Searching directories [`Dir1`,`Dir2`] | | +| harvester src.plotting.plot_tools | INFO | Loaded a total of `N` plots of size `size` TiB, in `time` seconds | | +| harvester src.harvester.harvester | INFO | `X` plots were eligible for farming `hex`... Found `Y` proofs. Time: `Time` s. Total `Z` plots | This is a vital message and should be seen at regular intervals. Note that `Time` is ideally < 1s. If drive is in sleep mode, may show ~10 seconds, and should be prevented | +| wallet src.wallet.wallet_blockchain | INFO | 💰 Updated wallet peak to height `HEIGHT`, weight `WEIGHT`, | | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md index c3d5db6e00..002f7baf37 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md @@ -10,7 +10,7 @@ Port forwarding port 8444 can solve many sync issues and helps improve Chia's ne Port 8444 is the [port](https://en.wikipedia.org/wiki/Port_%28computer_networking%29) through which other Chia computers can communicate with your PC. When you set up port forwarding on port 8444, the Chia software on your computer can quickly talk to other PCs, link up, and start downloading and syncing with the Chia blockchain. -The network is undergoing rapid growth and expansion. Many of the newly arrived Chia peers (computers) do not open up port 8444. It makes it very hard for the network. So please port forward on port 8444! +The network is undergoing rapid growth and expansion. Many of the newly arrived Chia peers (computers) do not open up port 8444. Therefore, it is strongly recommended that you enable port forwarding. Use [this port checker](https://portchecker.co/) to check if your router's port 8444 is closed. @@ -30,15 +30,15 @@ Here are the settings most routers will ask for: ## Why forward port 8444? -All peers (computers) with a closed port 8444 are completely dependent on pc peers with open port 8444. They are the only PCs they can talk to. If you got 1,000 nodes with an open port 8444, but 20,000 nodes with a closed port 8444, trying to sync, it will only just be able to theoretically have enough IP's estimated 3,000 can sync at a time, while the other wait for another open Chia user with open port 8444. Right now (Mid April '20) it seems that number is even much worse. And it causes a scenario where there just isn't enough open port 8444 peers to serve all the closed port 8444 peers. The only way around this is to ensure that you got an open port 8444. +All newly added nodes are completely dependent on nodes that are allowing port forwarding, because they are the only nodes in which they can sync with. The more nodes there are that don't allow port forwarding can cause a bottleneck to those nodes that do have it enabled. -If you somehow are able to open up your port 8444 you will quickly have peers connecting to you and have a much easier time to get connections established. +If you enable port forwarding, your node will sync faster, and you will be helping to ensure the stability and overall health of the Chia network. ## Speed up connecting to nodes If you would like to speed up connectivity to other nodes and increase your sync speed, add the introducer node to your Chia client: - - - Mainnet Introducer: `introducer.chia.net:8444` +``` +- Mainnet Introducer: `introducer.chia.net:8444` - Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. - - CNI Operated Full Node: `node.chia.net` +Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. +- CNI Operated Full Node: `node.chia.net` - Additionally, you can also visit either of the below websites that are frequently updated with available nodes listening on port 8444: - - [ChiaNodes.com](https://ChiaNodes.com) - - [chia.keva.app](https://chia.keva.app) +Additionally, you can also visit either of the below websites that are frequently updated with available nodes listening on port 8444: +- [ChiaNodes.com](https://ChiaNodes.com) +- [chia.keva.app](https://chia.keva.app) +``` - - DNS Introducer: `dns-introducer-testnet11.chia.net` - - Legacy Introducer: `introducer-testnet11.chia.net:58444` +``` +- DNS Introducer: `dns-introducer-testnet11.chia.net` +- Legacy Introducer: `introducer-testnet11.chia.net:58444` - Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. - - CNI Operated Full Node: `testnet11-node.chia.net` +Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. +- CNI Operated Full Node: `testnet11-node.chia.net` +``` -Nodes (IPs) from these sites can be added in the GUI from the Full Node tab, select the Full Node button in the top right corner and then choose "Connect to Other Peers". You can also add nodes via the CLI with the command `chia peer full_node -a PEER_ADDRESS:PORT` where `PORT` will typically be 8444. +Nodes (IPs) from these sites can be added in the GUI from the Full Node tab, select the Full Node button in the top right corner and then choose "Connect to Other Peers". These can be added in the GUI via the button, or via the CLI with `chia show -a PEER_ADDRESS:PORT` where `PORT` will usually be 8444. -# Detailed explanation +## Detailed explanation -A regular pc can communicate **out** with endless ports-- if the user is sending a signal out -- pc opens a port -- signal goes out, pc closes the port. -Chia uses port 8444 as instant verified communication. So an open port can allow instant communication and start the blockchain sync. Signal comes in on port 8444- that Chia pc is verified, then **both** user's pc, opens their own "communication ports ex port 8421" and that new user can now sync and now they are linked together forming part of Chia mesh. +A regular pc can communicate **out** with endless ports-- if the user is sending a signal out -- pc opens a port -- signal goes out, pc closes the port. Chia uses port 8444 as instant verified communication. So an open port can allow instant communication and start the blockchain sync. Signal comes in on port 8444- that Chia pc is verified, then **both** user's pc, opens their own "communication ports ex port 8421" and that new user can now sync and now they are linked together forming part of Chia mesh. If the users port 8444 is closed, the users pc has to start sending multiple signals out and hope that a pc with open port 8444 will link with them, then the sync starts. (1) pc can only link up a few pc and with so many other Chia users coming on board, they all have to wait. Keep in mind, Chia is built on a mesh network, the blockchain is shared among all the users, not from central pc. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/timelords.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/timelords.md new file mode 100644 index 0000000000..54d15611a0 --- /dev/null +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/timelords.md @@ -0,0 +1,121 @@ +--- +title: Timelords +slug: /troubleshooting/timelords +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +## Checking Timelord Logs + +:::info +Make sure to set your logs to INFO for the below commands to work. +To do so run: `chia configure --log-level INFO` +::: + +The below commands are for use with linux OS.\ +The `tail` command only pulls new information as it is added to the log files showing new information as it is added.\ +The `cat` command pulls all current data from the log files providing a snapshot of where it was and is currently. + +:::note +The matched strings are missing the first letter (E or S) intentionally.\ +This is due to the two instances of each log, for example the log where others create the proof of time has the string "Not skipping" while the log where your machine creates the PoT has the string "Skipping". +::: + +**Continuous:**\ +`tail -F ~/.chia/mainnet/log/debug.log | grep "stimated"` : running output of the current estimated IPS as seen by the network (note this will be lower than the IPS reported by the ASIC software).\ +`tail -F ~/.chia/mainnet/log/debug.log | grep "kipping"` : running output of peak heights being added to the node. If a height is skipped than very likely your timelord created the PoT, if the height is not skipped then a different timelord created the PoT. + +**Static:**\ +`cat ~/.chia/mainnet/log/debug.log | grep "stimated"` : static output of the current estimated IPS as seen by the network (note this will be lower than the IPS reported by the ASIC software).\ +`cat ~/.chia/mainnet/log/debug.log | grep "kipping"` : statis output of peak heights added to the node. If a height is skipped than very likely your timelord created the PoT, if the height is not skipped then a different timelord created the PoT. + +
+Example Estimated IPS Logs + +These logs indicate your timelord has completed a Proof of Time, note there are three VDF chains and the specific VDF that was completed will be indicated. Also note that this does not mean your timelord is the fastest timelord, only that it completed a PoT. + +```bash +cat ~/.chia/mainnet/log/debug.log | grep "stimated" +``` + +Response: + +``` +2024-04-11T16:59:01.482 timelord chia.timelord.timelord : INFO Finished PoT chall:79a8b30ee7aaa3064ac4.. 1981176 iters, Estimated IPS: 575336.2, Chain: Chain.REWARD_CHAIN +2024-04-11T16:59:01.588 timelord chia.timelord.timelord : INFO Finished PoT chall:027e1c04ae11d627179b.. 1981176 iters, Estimated IPS: 558173.6, Chain: Chain.INFUSED_CHALLENGE_CHAIN +2024-04-11T16:59:01.627 timelord chia.timelord.timelord : INFO Finished PoT chall:50cd37772d5bae2a00d4.. 1981176 iters, Estimated IPS: 552043.3, Chain: Chain.CHALLENGE_CHAIN +``` + +
+ +
+Example Skipping Peak Log + +These logs indicate your timelord is skipping the peak height, one can reasonably assume that they have completed the Proof of Time the fastest or at least as fast as the other timelords.\ +Note: a capital `S` is used here to just pull the Skipping peak logs. + +```bash +cat ~/.chia/mainnet/log/debug.log | grep "Skipping" +``` + +Response: + +``` +2024-05-01T06:30:27.983 timelord chia.timelord.timelord_api: INFO Skipping peak, already have. +``` + +
+ +
+Example Not Skipping Peak Log + +These logs indicate your timelord is not skipping the peak height, this means that your timelord was not the fastest at completing the PoT and it is getting the peak from a peer node.\ +Note: a lower case `s` is used here to just pull the Not skipping peak logs. + +```bash +cat ~/.chia/mainnet/log/debug.log | grep "skipping" +``` + +Response: + +``` +2024-05-01T06:30:27.983 timelord chia.timelord.timelord_api: INFO Not skipping peak, don't have. Maybe we are not the fastest timelord. +``` + +
+ +:::note +If you have set up the timelord services to run through systemD you can use the below command(s) for pulling those records. +::: + +**If running as a service:**\ +`journalctl -f -u chia-hw-vdf | grep "MHz"` : output of the ASIC timelord reported IPS (this will be higher than the estimated IPS as seen by the network). If not using systemD this information is available in the the terminal output where the `hw_vdf_client` command was run. + +## Common Timelord Error Logs + +### Chia logs + +``` +timelord chia.timelord.timelord : ERROR Error while handling message: Traceback (most recent call last): + File "chia/timelord/timelord.py", line 893, in _manage_chains + File "chia/timelord/timelord.py", line 440, in _submit_iterations + File "asyncio/streams.py", line 359, in drain + File "chia/timelord/timelord.py", line 221, in _stop_chain +``` + +This error occurs when the ASIC software has been shutdown unexpectedly and will start spamming your log file.\ +The current resolution is to restart the chia processes with something like `chia start full_node timelord-only -r`. + +### ASIC logs + +`Warning: too much work for VDF aux threads` - This generally means that the frequency is set too high, it is recommended to use the auto-frequency flag for the software to self adjust and resolve this error `--auto-freq 60` updates the frequency every 60 seconds.\ +`Bad data size after stop: -1` - This is a known logging error related to how the chia client and ASIC disconnect after a stop. There is no concern with having this error in your logs. + +--- + +## Timelord support + +Join Our [Discord](https://discord.gg/chia) and jump into the #support channel for support + +--- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md index 15bebf8109..20dd3d20d9 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md @@ -10,7 +10,7 @@ For more information, see our WalletConnect [Developer Guide](/walletconnect-dev ## Getting Started -You can install our [example WalletConnect dApp](https://github.com/Chia-Network/walletconnect-rpcs-dapp) and run it in your browser to test out WalletConnect. The code can be adapted for use in your own React applications. +You can install our [example WalletConnect dApp](https://github.com/Chia-Network/walletconnect-rpcs-dapp) and run it in your browser to test out WalletConnect. The code can be adapted for use in your own React applications. The code can be adapted for use in your own React applications. ## Commands @@ -250,25 +250,25 @@ Gets the current sync status of the wallet. ### TransactionRecord -| Parameter | Type | Description | -| ------------------- | --------------------------------------------------------------------------- | -------------------------------------- | -| `confirmedAtHeight` | `number` | Block height the tx was confirmed. | -| `createdAtTime` | `number` | The timestamp when the tx was created. | -| `toPuzzleHash` | `string` | The destination puzzle hash. | -| `amount` | `number` | The amount sent in mojos. | -| `feeAmount` | `number` | The transaction fee in mojos. | -| `confirmed` | `boolean` | Whether the tx was confirmed. | -| `sent` | `number` | Number of peers the tx was sent to. | -| `sentTo` | [`Peer[]`](/walletconnect-commands#peer) | The peers the tx has been sent to. | -| `spendBundle` | [SpendBundle](/walletconnect-commands#spendbundle) | null | The associated spend bundle. | -| `additions` | [`Coin[]`](/walletconnect-commands#coin) | Created coins in the block. | -| `removals` | [`Coin[]`](/walletconnect-commands#coin) | Spent coins in the block. | -| `walletId` | `number` | The wallet id. | -| `toAddress` | `string` | The bech32m encoded `to_puzzle_hash`. | -| `trade_id` | string | null | | -| `type` | [`TransactionType`](/walletconnect-commands#transactiontype) | The type of transaction. | -| `name` | `string` | The transaction's id. | -| `memos` | `Memo[]` | The memos associated with the tx. | +| Parameter | Type | Description | +| ------------------- | ------------------------------------------------------------ | -------------------------------------- | +| `confirmedAtHeight` | `number` | Block height the tx was confirmed. | +| `createdAtTime` | `number` | The timestamp when the tx was created. | +| `toPuzzleHash` | `string` | The destination puzzle hash. | +| `amount` | `number` | The amount sent in mojos. | +| `feeAmount` | `number` | The transaction fee in mojos. | +| `confirmed` | `boolean` | Whether the tx was confirmed. | +| `sent` | `number` | Number of peers the tx was sent to. | +| `sentTo` | [`Peer[]`](/walletconnect-commands#peer) | The peers the tx has been sent to. | +| `spendBundle` | [SpendBundle](/walletconnect-commands#spendbundle) | null | The associated spend bundle. | +| `additions` | [`Coin[]`](/walletconnect-commands#coin) | Created coins in the block. | +| `removals` | [`Coin[]`](/walletconnect-commands#coin) | Spent coins in the block. | +| `walletId` | `number` | The wallet id. | +| `toAddress` | `string` | The bech32m encoded `to_puzzle_hash`. | +| `trade_id` | string | null | | +| `type` | [`TransactionType`](/walletconnect-commands#transactiontype) | The type of transaction. | +| `name` | `string` | The transaction's id. | +| `memos` | `Memo[]` | The memos associated with the tx. | ### TransactionType @@ -293,7 +293,7 @@ This is a tuple with the following parameters. | ---------------------------- | ------------------------------------------------------------ | -------------------------- | | `peerId` _(item 1)_ | `string` | Peer id. | | `inclusionStatus` _(item 2)_ | [`InclusionStatus`](/walletconnect-commands#inclusionstatus) | Inclusion status. | -| `errorMessage` _(item 3)_ | string | null | Error message, if present. | +| `errorMessage` _(item 3)_ | string | null | Error message, if present. | ### InclusionStatus diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md index 54a4832434..a0f160a5ea 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md @@ -34,17 +34,17 @@ The output is an object of type [`NftInfo`](#nftinfo). ### `chia_mintNFT` -| Parameter | Type | Description | -| -------------------------------- | ------------------------------- | ------------------------------------- | -| `walletId` | `number` | NFT wallet id. | +| Parameter | Type | Description | +| -------------------------------- | ------------------------- | ------------------------------------- | +| `walletId` | `number` | NFT wallet id. | | `royaltyAddress` _(optional)_ | string | null | Address royalty is sent to. | | `royaltyPercentage` _(optional)_ | number | null | Creator royalty percent. (1000 = 1%) | | `targetAddress` _(optional)_ | string | null | Address NFT is sent to upon mint. | -| `uris` | `string[]` | List of NFT content URIs. | -| `hash` | `string` | Hash of the NFT content. | -| `metaUris` | `string[]` | List of metadata URIs. | +| `uris` | `string[]` | List of NFT content URIs. | +| `hash` | `string` | Hash of the NFT content. | +| `metaUris` | `string[]` | List of metadata URIs. | | `metaHash` _(optional)_ | string | null | Hash of the metadata. | -| `licenseUris` | `string[]` | List of the license URIs. | +| `licenseUris` | `string[]` | List of the license URIs. | | `licenseHash` _(optional)_ | string | null | Hash of the license. | | `editionNumber` _(optional)_ | number | null | Number of the current NFT in edition. | | `editionTotal` _(optional)_ | number | null | How many NFTs in the current edition. | @@ -74,7 +74,7 @@ The output is an object of type [`NftInfo`](#nftinfo). | Parameter | Type | Description | | --------------------- | ---------------------------------------------------- | --------------------- | -| `walletId` | number | number[] | NFT wallet id(s). | +| `walletId` | number | number[] | NFT wallet id(s). | | `spendBundle` | [`SpendBundle`](/walletconnect-commands#spendbundle) | Created spend bundle. | | `txNum?` _(optional)_ | `number` | Transaction number. | @@ -116,32 +116,32 @@ Sets the owner DID associated with a given NFT. ### NFTInfo -| Parameter | Type | Description | -| --------------------------- | ------------------------------- | -------------------------------------- | -| `nftId` | `string` | The NFT id. | -| `launcherId` | `string` | The launcher id. | -| `nftCoinId` | `string` | The current coin id. | -| `nftCoinConfirmationHeight` | `number` | Current NFT coin confirmation height | +| Parameter | Type | Description | +| --------------------------- | -------------------------- | -------------------------------------- | +| `nftId` | `string` | The NFT id. | +| `launcherId` | `string` | The launcher id. | +| `nftCoinId` | `string` | The current coin id. | +| `nftCoinConfirmationHeight` | `number` | Current NFT coin confirmation height | | `ownerDid` | string | null | The owner DID. | | `royaltyPercentage` | number | null | Creator royalty percent. (1000 = 1%) | | `royaltyPuzzleHash` | string | null | Puzzle hash royalty is sent to. | -| `royaltyAddress` | `string` | Address royalty is sent to. | -| `targetAddress` | `string` | Address NFT is sent to upon mint. | -| `uris` | `string[]` | List of NFT content URIs. | -| `hash` | `string` | Hash of the NFT content. | -| `metaUris` | `string[]` | List of metadata URIs. | -| `metaHash` | `string` | Hash of the metadata. | -| `licenseUris` | `string[]` | List of the license URIs. | -| `licenseHash` | `string` | Hash of the license. | -| `editionTotal` | `number` | How many NFTs in the current edition. | -| `editionNumber` | `number` | Number of the current NFT in edition. | -| `updaterPuzhash` | `string` | Puzzle hash of the metadata updater. | -| `chainInfo` | `string` | Information saved on the chain. | -| `mintHeight` | `number` | Block height when the NFT was minted. | -| `supportsDid` | `boolean` | Whether the inner puzzle supports DID. | -| `p2Address` | `string` | The innermost puzzle hash of the NFT. | -| `pendingTransaction` | `boolean` | Whether the NFT is pending for a tx. | +| `royaltyAddress` | `string` | Address royalty is sent to. | +| `targetAddress` | `string` | Address NFT is sent to upon mint. | +| `uris` | `string[]` | List of NFT content URIs. | +| `hash` | `string` | Hash of the NFT content. | +| `metaUris` | `string[]` | List of metadata URIs. | +| `metaHash` | `string` | Hash of the metadata. | +| `licenseUris` | `string[]` | List of the license URIs. | +| `licenseHash` | `string` | Hash of the license. | +| `editionTotal` | `number` | How many NFTs in the current edition. | +| `editionNumber` | `number` | Number of the current NFT in edition. | +| `updaterPuzhash` | `string` | Puzzle hash of the metadata updater. | +| `chainInfo` | `string` | Information saved on the chain. | +| `mintHeight` | `number` | Block height when the NFT was minted. | +| `supportsDid` | `boolean` | Whether the inner puzzle supports DID. | +| `p2Address` | `string` | The innermost puzzle hash of the NFT. | +| `pendingTransaction` | `boolean` | Whether the NFT is pending for a tx. | | `didId` | string | null | The DID used during an NFT mint. | | `minterDid` | string | null | The minter DID. | -| `launcherPuzhash` | `string` | Singleton launcher puzzle hash. | +| `launcherPuzhash` | `string` | Singleton launcher puzzle hash. | | `offChainMetadata` | string | null | Serialized off-chain metadata. | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md index 016380576c..50a410aa13 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md @@ -155,17 +155,17 @@ Creates an offer for wallet ids. | Parameter | Type | Description | | ------------------ | -------------------------------------------------- | -------------------------------------------- | -| `acceptedAtTime` | number | null | Timestamp when the trade was accepted. | +| `acceptedAtTime` | number | null | Timestamp when the trade was accepted. | | `coinsOfInterest` | [`Coin[]`](/walletconnect-commands#coin) | Coins involved in trade. | | `confirmedAtIndex` | `number` | Confirmation block index. | | `createdAtTime` | `number` | Timestamp when the trade was created. | | `isMyOffer` | `boolean` | Whether this is the wallet's own offer. | -| `pending` | `Record` | Pending amounts. | +| `pending` | `Record` | Pending amounts. | | `sent` | `number` | Number of peers the transaction was sent to. | | `sentTo` | [`Peer[]`](/walletconnect-commands#peer) | Peers the transaction was sent to. | | `status` | [`TradeStatus`](/walletconnect-offers#tradestatus) | Trade status. | | `summary` | `any` | Trade summary metadata. | -| `takenOffer` | string | null | Taken bech32m encoded offer data. | +| `takenOffer` | string | null | Taken bech32m encoded offer data. | | `tradeId` | `string` | Trade id. | | `_offerData` | `string` | Bech32m encoded offer data. | From c779411071a6c6b121795bc1633e532b1e2052b1 Mon Sep 17 00:00:00 2001 From: ClydeWallace22 <48610606+BrandtH22@users.noreply.github.com> Date: Wed, 24 Jul 2024 11:21:01 -0600 Subject: [PATCH 2/4] fix cn language slugs --- .../current/architecture/architecture-overview.md | 2 +- .../current/architecture/farmers.md | 2 +- .../current/architecture/full-nodes.md | 2 +- .../current/architecture/harvesters.md | 2 +- .../current/block-validation/block-format.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md index 1c76be1a45..f8338c3c13 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/architecture-overview.md @@ -1,6 +1,6 @@ --- title: 架构概览 -slug: 架构概览 +slug: /architecture-overview --- ![chia架构](/img/chia-network-architecture.png) diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md index 52082be761..7bfa2a7422 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/farmers.md @@ -1,6 +1,6 @@ --- title: 耕种 -slug: 耕种架构 +slug: /farmer-architecture --- Chia的农民与比特币矿工相似。 他们通过在其储存的地块中找到有效的空间证明来获得区块奖励和费用。 耕种进程并不会保留一个区块链的副本，而由他们信任的一个完整节点来提供更新。 完整节点和耕种进程使用耕种协议相互沟通。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md index 6d4110c10b..89e247aef1 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/full-nodes.md @@ -1,6 +1,6 @@ --- title: 全节点 -slug: /全节点架构 +slug: /full-node-architecture --- Chia点对点系统的核心由全节点组成。 全节点有以下几项责任： diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md index 1fbb019373..88cbdca06d 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/architecture/harvesters.md @@ -1,6 +1,6 @@ --- title: 收割机 -slug: 收割机架构 +slug: /harvester-architecture --- 收割机是一些独立的机器，由农民控制。 在大规模耕作活动中，农民可能与许多收割机连接在一起。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md index ebb6018ea2..7d2e5509c1 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-format.md @@ -1,6 +1,6 @@ --- title: 区块格式 -slug: /区块格式 +slug: /block-format --- ## 完整块 From 17b8c0034224a23645b1d73dc5626810361fd04a Mon Sep 17 00:00:00 2001 From: ClydeWallace22 <48610606+BrandtH22@users.noreply.github.com> Date: Wed, 24 Jul 2024 12:59:28 -0600 Subject: [PATCH 3/4] resolve misc translation errors - fix duplicate strings - fix broken anchors - fix various typos --- docs/rpc-reference/wallet.md | 4 +- .../academy/chialisp/chialisp-inner-puzzle.md | 2 +- .../academy/chialisp/chialisp-intro.md | 2 +- .../academy/chialisp/chialisp-signatures.md | 2 +- .../academy/chialisp/chialisp-smart-coin.md | 2 +- .../current/farming/farming-many-machines.md | 4 +- .../current/farming/pool-farming.md | 4 +- .../current/getting-started/farming-guide.md | 61 +-- .../current/getting-started/installation.md | 448 ++---------------- .../current/getting-started/timelords.md | 17 +- .../green-paper/green-paper-appendix.md | 71 ++- .../green-paper/hash-and-vdf-chains.md | 30 +- .../recovering-from-51-percent-attacks.md | 75 ++- .../green-paper/the-chia-blockchain.md | 108 +++-- .../guides/cat/cat-creation-tutorial.md | 82 +--- .../guides/cat/cat2-upgrade/cat2-issuance.md | 3 - .../guides/cat/cat2-upgrade/cat2-snapshot.md | 30 +- .../current/guides/cat/cr-cat-tutorial.md | 39 -- .../clawback/clawback-primitive-guide.md | 2 - .../guides/crash-course/cats-offers-nfts.md | 62 ++- .../guides/custody/custody-tool-user-guide.md | 57 ++- .../current/guides/custody/prefarm-audit.md | 10 +- .../current/guides/nft/nft-bulk-mint.md | 27 +- .../current/plotting/plotting-how-to.md | 2 +- .../current/rpc-reference/wallet.md | 50 +- .../current/troubleshooting/node-syncing.md | 52 +- 26 files changed, 439 insertions(+), 807 deletions(-) diff --git a/docs/rpc-reference/wallet.md b/docs/rpc-reference/wallet.md index d97607d3af..623dff7c38 100644 --- a/docs/rpc-reference/wallet.md +++ b/docs/rpc-reference/wallet.md @@ -2818,7 +2818,7 @@ Request Parameters: | batch_size | NUMBER | False | The number of coins to spend per bundle, [Default: `batch_size` obtainable from [get_auto_claim](#get_auto_claim)] | | fee | NUMBER | False | An optional blockchain fee, in mojos | -When examing the on-chain metadata for a transaction, a coin with `"type": 6` is a clawback coin to be received by this wallet, and a coin with `"type": 7` is a clawback coin sent from this wallet. +When examining the on-chain metadata for a transaction, a coin with `"type": 6` is a clawback coin to be received by this wallet, and a coin with `"type": 7` is a clawback coin sent from this wallet.
Example @@ -3220,7 +3220,7 @@ Response: ### `cat_get_asset_id` -Functionality: Retrieve a the asset ID from a CAT wallet +Functionality: Retrieve the asset ID from a CAT wallet Usage: chia rpc wallet [OPTIONS] cat_get_asset_id [REQUEST] diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md index 882f6483a9..fcb26aec47 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-inner-puzzle.md @@ -123,7 +123,7 @@ import Runnable from '@site/src/components/Runnable.tsx'; ### 可运行的Chialisp和clvm插件 -有关使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins)。 +有关使用这些插件的信息，请参阅[学院概述](/academy-overview#可运行的chialisp和clvm插件)。 #### Chialisp 插件 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md index 24cb016278..c56c81ed0d 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md @@ -180,7 +180,7 @@ So let's get started, the first thing you'll want to do is make sure you have th ### 可运行的Chialisp和clvm插件 -有关如何使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins) +有关如何使用这些插件的信息，请参阅[学院概述](/academy-overview#可运行的chialisp和clvm插件) #### Chialisp 插件 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md index 27b1510ffd..2e2eeb55dd 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-signatures.md @@ -142,7 +142,7 @@ import Runnable from '@site/src/components/Runnable.tsx'; ### 可运行的Chialisp和clvm插件 -有关使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins)。 +有关使用这些插件的信息，请参阅[学院概述](/academy-overview#可运行的chialisp和clvm插件)。 #### Chialisp 插件 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md index 1e7f8704d9..f339247361 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-smart-coin.md @@ -195,7 +195,7 @@ True ### 可运行的Chialisp和clvm插件 -有关使用这些插件的信息，请参阅[学院概述](/academy-overview#runnable-chialisp-and-clvm-plugins)。 +有关使用这些插件的信息，请参阅[学院概述](/academy-overview#可运行的chialisp和clvm插件)。 #### Chialisp 插件 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md index acbc7c17ff..e51cb519dd 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-many-machines.md @@ -187,7 +187,7 @@ chia start -r farmer #### 在多台机器上生成地块 -As stated [above](/farming-on-many-machines#prerequisites), run the following command when creating plots: +As stated [above](/farming-on-many-machines#先决条件), run the following command when creating plots: ```bash chia plots create -f -p @@ -197,7 +197,7 @@ When you use the `-f` and `-p` parameters, you do not need to copy the keys to t #### 在多台机器上进行收割 -Rather than maintaining a copy of your farmer's certificates on each harvester, follow the [above](/farming-on-many-machines#prerequisites) steps to keep them in one place while farming. +Rather than maintaining a copy of your farmer's certificates on each harvester, follow the [above](/farming-on-many-machines#先决条件) steps to keep them in one place while farming. ### 钱包保持独立(Separate) diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md index 0572af6973..4eaff1758b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md @@ -15,7 +15,7 @@ Chia的联合耕种协议（pooling protocol）允许将地块分配给“联合 :::note -The official pooling protocol was introduced in verion 1.2 in mid-2021. All plots created before this point, as well as newer plots created with following the pooling protocol, are not eligible for pooling. The official pooling protocol was introduced in verion 1.2 in mid-2021. All plots created before this point, as well as newer plots created with following the pooling protocol, are not eligible for pooling. If you have any of these "OG" plots, you can either recreate them using a plot NFT, or co-farm them on the same machine as your official pool plots. +The official pooling protocol was introduced in version 1.2 in mid-2021. All plots created before this point, as well as newer plots created with following the pooling protocol, are not eligible for pooling. The official pooling protocol was introduced in version 1.2 in mid-2021. All plots created before this point, as well as newer plots created with following the pooling protocol, are not eligible for pooling. If you have any of these "OG" plots, you can either recreate them using a plot NFT, or co-farm them on the same machine as your official pool plots. ::: @@ -112,7 +112,7 @@ You can now start creating plots for this Plot NFT, which means these plots will Detailed instructions can be found in the "How to Plot" page: - Plotting from the [CLI](/plotting-how-to#cli-plotting) -- Plotting from the [GUI](/plotting-how-to#gui-plotting) +- Plotting from the [GUI](/plotting-how-to#图形用户界面gui生成地块) ### 第五步：管理联合耕种农田。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md index b169488e45..043ac74a80 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/farming-guide.md @@ -6,6 +6,9 @@ slug: /farming-guide import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; +import WalletKeyDetails from '@site/static/img/troubleshooting/wallet_key_details.png'; +import WalletKeysPublic from '@site/static/img/faq/wallet_keys_public_key.png'; +import WalletLogout from '@site/static/img/troubleshooting/wallet_logout.png'; So you want to be a Chia farmer? You've come to the right place! @@ -63,7 +66,8 @@ In order to store the blockchain database, an SSD with at least 520 MB/s read/wr :::info -Let's say you have a computer without much free space. If you add a 1024-GB external SSD, it will be sufficient to create and store a plot, as well as to store the blockchain database. This will not be an ideal setup for creating a larger farm. But if you already have this equipment, you can set up a small farm without spending any money. +Let's say you have a computer without much free space. If you add a 1024-GB external SSD, it will be sufficient to create and store a plot, as well as to store the blockchain database. This will not be an ideal setup for +creating a larger farm. But if you already have this equipment, you can set up a small farm without spending any money. ::: @@ -78,7 +82,6 @@ Two check boxes will be shown on the last screen after the install has completed
Check both boxes
-
## Run and configure Chia @@ -88,7 +91,6 @@ The first time Chia starts, you will be given the option to run in either Wallet
Choose farming mode
-
### Create a wallet @@ -98,23 +100,21 @@ Assuming you don't have a wallet yet, click `CREATE A NEW WALLET KEY` (If you al
Create a new wallet key
-
-You will be presented with a list of twenty-four words. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is important. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is also important. +You will be presented with a list of twenty-four words. This is your wallet's recovery phrase. These words are all that are needed to recover your wallet on a new computer. Write them down and store them in a safe place. The order of the words is also important. -You can also choose a custom name for your wallet. Click `NEXT` when you are finished. Click `NEXT` when you are finished. +You can also choose a custom name for your wallet. Click `NEXT` when you are finished. :::warning -If someone obtains a copy of these words, they can steal your entire wallet, including all of its funds. Be sure to store your recovery phrase in a safe place. Be sure to store your recovery phrase in a safe place. +If someone obtains a copy of these words, they can steal your entire wallet, including all of its funds. Be sure to store your recovery phrase in a safe place. -::: +:::
Wallet seed phrase
-
You will be taken to your wallet, which will show a zero-XCH balance. There will be two round icons in the upper-right corner, one for the full node and one for the wallet: @@ -125,14 +125,14 @@ You will be taken to your wallet, which will show a zero-XCH balance. There will
Zero wallet balance
-
### Fund your wallet If you think you will ever want to join a pool (recommended for small and medium farms), you will need at least one mojo (one trillionth of an XCH). To help with this, we have set up an online faucet at [faucet.chia.net](https://faucet.chia.net/). -To use the faucet you will need to identify your **Master Public Key** (also referred to as the **Public Key**). You can use either the GUI or CLI to identify the Master Public Key by following these steps: +To use the faucet you will need to identify your **Master Public Key** (also referred to as the **Public Key**). +You can use either the GUI or CLI to identify the Master Public Key by following these steps: #### GUI @@ -191,7 +191,7 @@ For more security best practices please review the [Securing Your Chia – How t :::info -You can continue with this guide while waiting for your 100 mojos to arrive. +You can continue with this guide while waiting for your faucet payment to arrive. ::: @@ -202,7 +202,6 @@ Click the `Full Node` icon on the left side of your wallet:
Syncing from genesis
-
This screen shows your node's syncing status. In order to farm Chia, your node needs to be fully synced. You have two options to achieve this: @@ -253,12 +252,11 @@ Click the `Pooling` icon on the left side of your wallet, and click `JOIN A POOL
Join a pool
-
Before you can join a pool, you will need to create a plot NFT. This will allow you to easily change pools later. -Select `Connect to pool`. You will need to enter a valid pool URL. We will use OpenChia for this example, but there are many great pools to choose from. `Connect to pool` -- You will need to enter a valid pool URL. We will use OpenChia for this example, but there are many great pools to choose from. For a list of reputable pools, see [Chialinks.com](https://chialinks.com/pools/). (Chia Network, Inc. does not run a pool, and is not affiliated with OpenChia or Chialinks). (Chia Network Inc. does not run a pool, and is not affiliated with OpenChia or Chialinks). +Select `Connect to pool`. You will need to enter a valid pool URL. We will use OpenChia for this example, but there are many great pools to choose from. For a list of reputable pools, see [Chialinks.com](https://chialinks.com/pools/). (Chia Network Inc. does not run a pool, and is not affiliated with OpenChia or Chialinks). :::info @@ -266,12 +264,11 @@ If you don't want to join a pool, select `Self pool`. This will assign you to a ::: -Creating a plot NFT requires an on-chain transaction that will cost one mojo. You are also recommended to enter a blockchain fee. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes. You are also recommended to enter a blockchain fee. If you used the faucet, you will now have 100 mojos. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes. +Creating a plot NFT requires an on-chain transaction that will cost one mojo. You are also recommended to enter a blockchain fee. If you used the faucet, you will now have 100 mojos. Depending on how busy the network is, a one-mojo fee is typically enough to complete your transaction within a few minutes.
Create a plot NFT
-
:::info @@ -282,20 +279,18 @@ If your faucet payout has not arrived after more than 10 minutes, someone on [Di ::: -If you entered a valid pool URL, the details will pop up. For example, this pool has a fee of 1%. If everything looks acceptable, click `CREATE`: For example, this pool has a fee of 1%. If everything looks acceptable, click `CREATE`: +If you entered a valid pool URL, the details will pop up. For example, this pool has a fee of 1%. If everything looks acceptable, click `CREATE`:
Pool details
-
-Your transaction will be pushed to the blockchain. While it is pending, a new screen will appear: While it is pending, a new screen will appear: +Your transaction will be pushed to the blockchain. While it is pending, a new screen will appear:
Plot NFT pending
-
After the transaction has been finalized (typically 1-3 minutes), the details of your plot NFT will appear: @@ -303,7 +298,6 @@ After the transaction has been finalized (typically 1-3 minutes), the details of
Plot NFT details
-
A two-word name will automatically be assigned to your plot NFT, in this case "Harlequin Koala". In order to determine how much space you are contributing, your pool will periodically send you challenges. If you want to change pools later, simply return to this screen and click `CHANGE POOL`. @@ -316,7 +310,7 @@ Pools typically require you to wait for 30 minutes before leaving. This is to pr :::info -Chia's pooling protocol has several significant advantages over pools on other blockchains. Read more about these advantages, as well as the technical details of how the protocol works, in our [pooling section](/introduction#pooling). +Chia's pooling protocol has several significant advantages over pools on other blockchains. Read more about these advantages, as well as the technical details of how the protocol works, in our [pooling section](/introduction#矿池pooling). ::: @@ -331,7 +325,6 @@ From the Chia application, click the `Farm` icon and click `ADD A PLOT`:
Add a plot
-
If you previously created a plot NFT, it will show up now. The plots you create will be associated with this NFT. It is important that you associate all of your plots to the same NFT in order to farm to a pool, as well as to be able to change pools easily if desired. As long as your plot NFT shows up here, there is no need to change it: @@ -339,7 +332,6 @@ If you previously created a plot NFT, it will show up now. The plots you create
Plot NFT
-
Next, you will need to choose a plotter. When creating a single plot, `Chia Proof of Space` and `madMAx` both will work on almost all hardware. The plot from this example was created with `madMAx` because it requires the smallest amount of temporary disk space. @@ -348,20 +340,18 @@ Next, you will need to choose a plotter. When creating a single plot, `Chia Proo When building a larger farm, the plotter you choose will depend greatly on your available hardware. It may help to experiment with multiple plotters to get a feel for which ones work best for your setup. For details on each of the available plotters, see our [Plotting Software](/plotting-software) section. -::: +:::
Choose plotter
-
For the `Keys` section, you typically won't need to change anything.
- 密钥 + Keys
-
Next, you will need to choose a `k` value, and possibly a compression level. @@ -381,7 +371,6 @@ Certain plotters are also capable of creating compressed plots, which are discus
Choose K value
-
Next, you need to select the temporary and final directories for your plot. The medium for temporary storage will greatly affect the speed at which your plot is created: @@ -390,7 +379,7 @@ Next, you need to select the temporary and final directories for your plot. The - **SSD** -- Most farmers choose to use an enterprise NVMe SSD for the temporary storage. These SSDs can handle large amounts of reads and writes in their lifetimes. - **HDD** -- If you don't mind plotting slowly, you can choose a directory located on an HDD. -The final directory is where the plot will be copied after it has been created. The final directory is where the plot will be copied after it has been created. Most farmers will choose to use an HDD as the final directory. However, for this tutorial an NVMe SSD was used for both the temporary and final directories. +The final directory is where the plot will be copied after it has been created. Most farmers will choose to use an HDD as the final directory. However, for this tutorial an NVMe SSD was used for both the temporary and final directories. :::warning @@ -403,15 +392,13 @@ You will also need to choose how many plots to create. Certain plotters can be o
Temporary and final directories
-
-After you have gone through all of these settings, click `CREATE`. You will be taken to a progress panel: You will be taken to a progress panel: +After you have gone through all of these settings, click `CREATE`. You will be taken to a progress panel:
Plot creation progress
-
The amount of time required to create this plot is highly dependent on your hardware. The world record time to create a k32 plot is around 30 seconds. The plot for this tutorial was created on a laptop in around 3 hours. @@ -431,7 +418,6 @@ Before you can begin farming, you need to be running a synced full node. Earlier
Synced node
-
Your node is now synced. If your plot has finished being created, you are also farming. To verify this, click the `Farm` icon: @@ -439,7 +425,6 @@ Your node is now synced. If your plot has finished being created, you are also f
Farm health
-
You will be shown a number of details about your farm. As long as the `Farm Health` section has all green icons, everything is working as expected. @@ -460,7 +445,7 @@ Once you have a small farm up and running, you can decide whether to expand, and - [Notes about SSD encurance](/ssd-endurance) - [How to move plots](/moving-plots) to their final destinations -## 如何获得帮助 +## How to Get Help - Get help on CNI's official [Discord](https://discord.gg/chia), in the `#farming-and-plotting` and `#support` channels. -- 在[生成地块问答](/plotting-faq)中获取更多问题的解答。 +- Get more questions answered in the [plotting FAQ](/plotting-faq). diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md index 38733f2bad..70e3d5fed9 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md @@ -8,13 +8,13 @@ import TabItem from '@theme/TabItem'; :::info -This page will go into the details of the various different ways to install Chia. This page will go into the details of the various different ways to install Chia. If you already installed Chia as part of the Farming Guide, then feel free to skip ahead to the [Plotting Basics](/plotting-basics) page. +This page will go into the details of the various different ways to install Chia. If you already installed Chia as part of the Farming Guide, then feel free to skip ahead to the [Plotting Basics](/plotting-basics) page. ::: There are various ways to install Chia, with the best method depending on what you intend to do: -- If you simply wish to use the Chia wallet, or to run a farm on a single personal computer, then we recommend installing the GUI from our [official downloads page](https://www.chia.net/downloads) for Windows and MacOS, and for Linux users to install the package [as described below](#using-the-cli). The GUI is the simplest way to interact with the Chia client and ideal for most non-developer use cases. The GUI is the simplest way to interact with the Chia client and ideal for most non-developer use cases. +- If you simply wish to use the Chia wallet, or to run a farm on a single personal computer, then we recommend installing the GUI from our [official downloads page](https://www.chia.net/downloads) for Windows and MacOS, and for Linux users to install the package [as described below](#using-the-cli). The GUI is the simplest way to interact with the Chia client and ideal for most non-developer use cases. - If you intend to run a dedicated Chia full node on a server and connect to it programmatically using the [RPC interface](/rpc), the best method would be to install and run Chia via the command line on a proper server environment. @@ -38,7 +38,7 @@ Chia plot files are at least 108GB in size (for K32). To plot successfully requi ### Sleep kills plots -If the computer or hard drives go to sleep during the plotting process, it will fail, and you will need to start over. Please ensure all sleep, hibernate and power saving modes for your computer and hard drives are disabled before starting the Chia plotting process. In the future, Chia will have a resume plot feature. In the meantime, if you do get a failed plot, delete all `*.tmp` files before starting a new plot. Please ensure all sleep, hibernate and power saving modes for your computer and hard drives are disabled before starting the Chia plotting process. In the future, Chia will have a resume plot feature. In the meantime, if you do get a failed plot, delete all `*.tmp` files before starting a new plot. +If the computer or hard drives go to sleep during the plotting process, it will fail, and you will need to start over. Please ensure all sleep, hibernate and power saving modes for your computer and hard drives are disabled before starting the Chia plotting process. In the future, Chia will have a resume plot feature. In the meantime, if you do get a failed plot, delete all `*.tmp` files before starting a new plot. --- @@ -110,7 +110,7 @@ sudo dnf install chia-blockchain :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Create virtual environment @@ -146,35 +146,7 @@ values={[ :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: - -```bash -# Download chia-blockchain -git clone https://github.com/Chia-Network/chia-blockchain -b latest --recurse-submodules - -# Change directory -cd chia-blockchain - -# Install dependencies -sh install.sh - -# Activate virtual environment -. ./activate - -# Initialize -chia init -``` - -The following is how you update to the latest version: - -```bash -# Change directory -cd chia-blockchain - -# Activate the virtual environment -. :::note -Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Download chia-blockchain @@ -208,6 +180,9 @@ chia stop -d all # Deactivate the virtual environment deactivate +# Remove the current virtual environment +rm -r venv + # Pull the latest version git fetch git checkout latest @@ -225,10 +200,6 @@ sh install.sh # Activate the virtual environment . ./activate -# Initialize the new version -chia init -``` ./activate - # Initialize the new version chia init ``` @@ -238,7 +209,7 @@ chia init :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Download chia-blockchain @@ -461,16 +432,6 @@ See [install from source](/installation#from-source) for detailed instruction. #### Install from binary package -```bash -# Install chia-blockchain as a binary package -python -m venv venv -ln -s venv/bin/activate -. #### Install from source - Amazon Linux 2 - -See [install from source](/installation#from-source) for detailed instruction. - -#### Install from binary package - ```bash # Install chia-blockchain as a binary package python -m venv venv @@ -486,13 +447,13 @@ pip install --extra-index-url https://pypi.chia.net/simple chia-blockchain miniu _**These instructions were tested with Chia 1.1.4 on FreeBSD 11.3- and 11.4-RELEASE, newer versions may exist**_ -\*\*\*==crwdHRulesLBB_2_BBsuleRHdwrc== +--- #### Upgrading Existing Chia Installs If you're upgrading from a previously built chia installation, exit from your previous venv environment (`deactivate`), create a new directory in which to place the latest Chia (e.g. `mkdir ~/chia-1.0.5 && cd ~/chia-1.0.5`), clone the latest repo (`git clone https://github.com/Chia-Network/chia-blockchain.git -b latest`), enter it and create a new Python virtual environment within it (`python3 -m venv venv`). Now, activate the newest environment (`. venv/bin/activate`), upgrade pip (`pip install --upgrade pip`). Now you may skip down to the [clvm_rs install section](#clvm_rs) and begin there. -\*\*\*==crwdHRulesLBB_2_BBsuleRHdwrc== +--- #### Why This Manual Installation? @@ -597,136 +558,19 @@ pkg install screen tmux git clone https://github.com/Chia-Network/chia-blockchain.git -b latest # or with SSH: git clone git@github.com:Chia-Network/chia-blockchain.git -b latest -# Note: you can specify the branch by adding "--branch Now, activate the newest environment (`. venv/bin/activate`), upgrade pip (`pip install --upgrade pip`). Now you may skip down to the [clvm_rs install section](#clvm_rs) and begin there. - ----==crwdHRulesLBB_2_BBsuleRHdwrc== - -#### Why This Manual Installation? - -Currently the only way to ensure Chia builds on FreeBSD is to do it from the source. By following these instructions to the letter, you should have no problem building the latest Chia from source on a FreeBSD 11.3 or 11.4. This should also work on FreeBSD 12, possibly with some modifications - e.g. if the ports py-cryptography version is newer than 3.3.2, simply edit as needed - or if your preferred Python version is 3.8+ it should all still work considering you modify the package names as necessary. +# Note: you can specify the branch by adding "--branch " like: git clone http://github.com/Chia-Network/chia-blockchain.git --branch 1.0.1 -#### Notes on FreeNAS (TrueNAS) - -If you had been using NFS or Samba sharing to expose your plots to a harvester on another OS, such as Linux, you can instead build Chia within a jail (see the FreeNAS manual for 'jails'), expose your plot directories to it and run the harvester within. In my experience, it provides lower-latency and more reliable access to the plots since the disks are direct-attached and not being provided through an extra few layers of network protocols. - -If you are using a fresh jail created by the FreeNAS web GUI you may need to install openssh and setup a ssh key to login as root because by default it appears PAM password logins do not work. The jail shell CLI provided by the FreeNAS GUI allows copy and pasting so you can easily paste your public-key into /root/.ssh/authorized_keys && chmod -R 700 /root/.ssh. - -These instructions would be applicable to 11.3 and 11.4 jails created within FreeNAS 11 only. Version 12 (FreeBSD 12) ✔ - -#### Other Notes - -These instructions will have you building both chia-blockchain and clvm_rs from github source, and python-cryptography from FreeBSD's ports. - -The result of this build will be the "chia version" showing the current release branch ahead by 1 and in "dev0"; for instance building 1.0.1 results in "chia version" returning "1.0.2.dev0". If someone knows why this is and how to fix it, please, edit and correct this! It does not happen on Linux. - -_**These instructions assume a fresh FreeBSD 11 installation!**_ - -#### Discouraged? - -Following the instructions in this document will result in a working Chia CLI build on FreeBSD 11 if you follow step-by-step starting from a vanilla FreeBSD installation. Is something broken? Compare the commands you typed, accessible in your **bash** shell history, and match them with each command in this document. If you feel you've messed something up, do the following: - -``` -# if you have (venv) in your shell prompt, type deactivate -deactivate -# remove the chia-blockchain directory which will contain clvm_rs and the Python venv -rm -rf chia-blockchain -# ... now start again! You don't need to do all the setup steps but instead may start at the upgrade notes above if you had finished up to the py-cryptography ports build. ``` -#### Pre-requisite package installation - -_If starting the build again after a failure and you have not re-installed FreeBSD, don't just skip this package installation section! You may have missed one or more software packages critical to the build._ - -The 'pkg', 'portsnap' and port build are to be run as root. Everything else can be run from a normal non-root user. - -As root, update pkg and ports, and then install all packages as instructed below. - -``` -# Update your packages and ports; if ports are already installed as part of your fresh install run portsnap update instead of fetch/extract. -pkg update -portsnap fetch && portsnap extract - -# Install bash if you have not; the default csh will not suffice for the build scripts. -pkg install bash -# change your shell to bash -chsh -s /usr/local/bin/bash -# run bash -/usr/local/bin/bash -``` - -Make sure you change the shell for your non-root chia-blockchain user. If you're opting to run Chia as root, you can skip this. If you are root, run this as it appears below; otherwise, you can omit the username because you are already that user. - -``` -chsh -s /usr/local/bin/bash NONROOT_USERNAME -``` - -Now proceed with installing the mandatory development tools. - -``` -pkg install lang/gcc9 gcc gmake cmake - -``` - -#### gcc notes - -After installing gcc version 9.0, this message appears: - -``` -To ensure binaries built with this toolchain find appropriate versions -of the necessary run-time libraries, you may want to link using - - -Wl,-rpath=/usr/local/lib/gcc9 -``` - -It's probably possible to build the libraries in a way that doesn't require `export LD_LIBRARY_PATH=/usr/local/lib/gcc9`. If you know how click "edit" and dish. - -#### Install rust, Python, and everything else. - -``` -pkg install lang/rust -pkg install lang/python37 py37-pip py37-setuptools py37-wheel py37-sqlite3 py37-cffi py37-virtualenv py37-maturin python -pkg install node npm git openssl -``` - -If you are ssh'ing into the machine you might want to use 'screen' so that processes will continue even if you logout. For more information: https://www.freebsd.org/cgi/man.cgi?query=screen. 'tmux' is also a great alternative especially if you use iTerm2 on macOS as it supports native tabs and windows with the '-CC' CLI option. - -``` -# optional packages -pkg install screen tmux -``` - -#### Repo Cloning and Virtual Environment (venv) Activation - -**From this point on, with the exception of the security/py-cryptography port build process (and any other exceptions noted), you may proceed as a normal user.** +Create a virtual environment directory 'venv' from _within_ the 'chia-blockchain' directory and activate it before proceeding ``` -# Clone the latest chia-blockchain repository, via HTTP: -git clone https://github.com/Chia-Network/chia-blockchain.git -b latest -# or with SSH: -git clone git@github.com:Chia-Network/chia-blockchain.git -b latest -# Note: you can specify the branch by adding "--branch :::note -Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: - -```bash -# Download chia-blockchain -git clone https://github.com/Chia-Network/chia-blockchain -b latest --recurse-submodules - -# Change directory cd chia-blockchain +python3 -m venv venv +source venv/bin/activate +``` -# Checkout the beta or release candidate by tag, tags can be found https://github.com/Chia-Network/chia-blockchain/tags. -git checkout tags/2.1.2-rc2 - -# Install dependencies -./Install.ps1 - -# Activate virtual environment -. ./venv/Scripts/Activate.ps1 - -# Initialize -chia init -``` You should have a "(venv)" prefix to your terminal prompt to confirm the venv is working. +You are now in the virtual environment that Python (and so chia) will use. You should have a "(venv)" prefix to your terminal prompt to confirm the venv is working. Upgrade pip: @@ -854,7 +698,7 @@ sed -i .bak 's/enable_upnp: True/enable_upnp: False' ~/.chia/mainnet/config/conf While you don't absolutely need port 8444 forwarded to your Chia node, it is advised that you do so that other peers may connect to you instead of you solely connecting to them. For the average at-home farmer it is advised you do not disable UPnP unless you absolutely know what you're doing or have another node on your local network already using the port and are planning to [Farm on Many Machines](https://docs.chia.net/farming-on-many-machines/). ----==crwdHRulesLBB_2_BBsuleRHdwrc== +--- #### Installed and Ready to Farm! @@ -975,211 +819,6 @@ The GUI can now be launched using the following commands: cd chia-blockchain . ./activate -cd chia-blockchain-gui -npm run electron -``` ./venv/bin/activate -pip install --upgrade pip - -cd ../chiavdf/ -pip install . - -cd ../maturin/ -# don't pass static compiler flags to the rust linker because that would cause -# a core dump, possibly because of resource limits -sed -i 's|cargo_args.extend(\["--", "-C", "link-arg=-s"\])|#cargo_args.extend(\["--", "-C", "link-arg=-s"\])|' setup.py -pip install . - -cd ../clvm_rs/ -maturin develop --release - -# XXX should be a more elegant way... -" like: git clone http://github.com/Chia-Network/chia-blockchain.git --branch 1.0.1 - -``` - -Create a virtual environment directory 'venv' from _within_ the 'chia-blockchain' directory and activate it before proceeding - -``` -cd chia-blockchain -python3 -m venv venv -source venv/bin/activate -``` - -You are now in the virtual environment that Python (and so chia) will use. You should have a "(venv)" prefix to your terminal prompt to confirm the venv is working. - -Upgrade pip: - -``` -pip install --upgrade pip -``` - -To exit the virtual environment: - -``` -deactivate -``` - -#### Building py-cryptography from ports - -_**You'll need to switch to root for this part. If you're already using root remember to leave the virtual environment for this step.**_ - -``` -cd /usr/ports/security/py-cryptography - -# Instruct 'make' that the SSL library is openssl. -# Also force the Python version in case the port tries for a higher one -echo "DEFAULT_VERSIONS+=ssl=openssl python=3.7 python3=3.7" >> /etc/make.conf - -make -``` - -You'll probably see a bunch of warnings and notices; these are not errors and it will build. - -Do NOT run make install. We will do our own py-cryptography install because 'make install' does not copy to our virtual environment. (If you know how to change this, please edit). - -If you are running inside a jail and make fails with an error about the OSVERSION not matching UNAME, you will need to set the UNAME_r environment variable to match your jails OSVERSION: - -``` -# Adjust the value to match your jails OSVERSION -export UNAME_r=11.4-RELEASE -``` - -A full version list can be found [here](https://docs.freebsd.org/en/books/porters-handbook/book.html#versions). - -Once complete switch back to your non-root user if you so optioned. You must now be in your venv once again. - -#### clvm_rs - -Build and install the current version of [clvm_rs](https://github.com/Chia-Network/clvm_rs). -These instructions were created for version 0.1.7 but a newer version may exist. - -``` -git clone http://github.com/Chia-Network/clvm_rs.git --branch 0.1.7 -cd clvm_rs -maturin develop --release -pip install git+https://github.com/Chia-Network/clvm@use_clvm_rs -``` - -clvm_rs 0.1.7 is now installed in your virtual environment. - -#### Install py-cryptography to the venv - -Copy py-cryptography and its meta-data from the staging directory to your virtual environment: - -``` -cp -R /usr/ports/security/py-cryptography/work-py37/stage/usr/local/lib/python3.7/site-packages/cryptography ${VIRTUAL_ENV}/lib/python3.7/site-packages/cryptography -cp -R /usr/ports/security/py-cryptography/work-py37/stage/usr/local/lib/python3.7/site-packages/cryptography-3.3.2-py3.7.egg-info ${VIRTUAL_ENV}/lib/python3.7/site-packages/cryptography-3.3.2-py3.7.egg-info -``` - -Clear any Python byte-code cache files that may contain the old path. These should be re-built by the interpreter but we like a clean environment. - -``` -find ${VIRTUAL_ENV}/lib/python3.7/site-packages/cryptography -name __pycache__ | xargs -I{} rm -rf "{}" -``` - -#### Chia modifications and Building Chia Itself - -Switch to your chia-blockchain clone directory. You will need to edit two files. - -Using your favorite text editor, modify setup.py to edit the cryptography package version to 3.3.2. - -``` -"cryptography==3.4.6" --> to --> "cryptography==3.3.2" -``` - -Now you must modify chia/util/keychain.py to provide a static key when using the Python keyring. This is mandatory otherwise every time the keyring is accessed your passphrase will need to be entered on the command line, and for the CLI daemon this will not do. - -On line 25 of chia/util/keychain.py, change: - -``` -elif platform=="linux": -``` - -to: - -``` -elif platform=="linux" or platform.startswith("freebsd"): -``` - -On line 27 of the same file, change the passphrase from "your keyring password" to whatever you wish your passphrase to be. This is intended to be fixed in future versions but, for the time being, Linux and FreeBSD must have the keyphrase provided statically. - -``` -keyring.keyring_key = "your keyring password" # type: ignore -``` - -can be changed like so: - -``` -keyring.keyring_key = "Too Many Secrets" -``` - -Now, you will build Chia! - -``` -sh install.sh -``` - -Once done, run: - -``` -chia init -``` - -NOTE: if you need to disable UPnP - a protocol which automatically sets up port-forwarding on routers using NAT which is a typical setup at any residence with broadband - set "enable_upnp: False" in config.yaml. You can use the one-liner below or do it yourself. - -``` -sed -i .bak 's/enable_upnp: True/enable_upnp: False' ~/.chia/mainnet/config/config.yaml -``` - -While you don't absolutely need port 8444 forwarded to your Chia node, it is advised that you do so that other peers may connect to you instead of you solely connecting to them. For the average at-home farmer it is advised you do not disable UPnP unless you absolutely know what you're doing or have another node on your local network already using the port and are planning to [Farm on Many Machines](https://docs.chia.net/farming-on-many-machines/). - -\*\*\*==crwdHRulesLBB_2_BBsuleRHdwrc== - -#### Installed and Ready to Farm! - -That's it! Provided the instructions were followed to the T, and the build is a fresh FreeBSD 11.3 or 11.4, either hardware or FreeNAS jailed, you should be good to go! Now go to town with `chia start node` or whatever floats your boat. - -More details can be found in the [Chia Introduction](https://docs.chia.net/introduction). - -_WARNING: Although the following steps have been used successfully, the resulting GUI will be run with an older version of electron than is recommended by the Chia Network team. This may result in unexpected problems._ - -#### Prerequisite package installation - -As root (or using doas / sudo), first install some additional OpenBSD packages required for GUI usage: - -```bash -pkg_add -i electron -``` - -#### Build - -```bash -cd chia-blockchain -. ./activate - -cd chia-blockchain-gui - -# build / set up GUI -npm run build - -# Remove failed electron 8.2.5 install and fall back to the OpenBSD -# ports tree 8.2.0 electron, which currently (as of 6/10/2020) works. -# -# This may not continue to work in the future. A full solution to -# this requires official OpenBSD electron builds, provided by the -# electron project itself. - -rm -rf node_modules/electron -``` - -#### Launch GUI - -The GUI can now be launched using the following commands: - -```bash -cd chia-blockchain -. ./activate - cd chia-blockchain-gui npm run electron ``` @@ -1235,14 +874,6 @@ This can be done by running the following command: export PATH=/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon:$PATH ``` -To load this on startup, add it to the `.bashrc`, `.bash_profile`, or `.zshrc` file depending on which is used by the shell. - -This can be done by running the following command: - -```bash -export PATH=/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon:$PATH -``` - To load this on startup, add it to the `.bashrc`, `.bash_profile`, or `.zshrc` file depending on which is used by the shell. @@ -1373,9 +1004,9 @@ chia start farmer ### Systemd -Linux users who have installed the `chia-blockchain-cli` package using [apt, yum, or dnf](https://docs.chia.net/installation/#using-the-cli) will receive systemd configuration files for initializing and managing the Chia processes. Each Chia service needs to be managed separately with systemd, except for the chia-daemon, which will be initialized automatically when any other Chia service is started with systemd (for example, the data-layer service will not automatically start the wallet service - both need to be started individually with systemd). A user must be specified during the initialization to ensure the resulting process can find the Chia root directory. The included systemd files support the default Chia directory location of `/home//.chia/mainnet` only. Each Chia service needs to be managed separately with systemd, except for the chia-daemon, which will be initialized automatically when any other Chia service is started with systemd (for example, the data-layer service will not automatically start the wallet service - both need to be started individually with systemd). A user must be specified during the initialization to ensure the resulting process can find the Chia root directory. The included systemd files support the default Chia directory location of `/home//.chia/mainnet` only. +Linux users who have installed the `chia-blockchain-cli` package using [apt, yum, or dnf](https://docs.chia.net/installation/#using-the-cli) will receive systemd configuration files for initializing and managing the Chia processes. Each Chia service needs to be managed separately with systemd, except for the chia-daemon, which will be initialized automatically when any other Chia service is started with systemd (for example, the data-layer service will not automatically start the wallet service - both need to be started individually with systemd). A user must be specified during the initialization to ensure the resulting process can find the Chia root directory. The included systemd files support the default Chia directory location of `/home//.chia/mainnet` only. -To start a Chia process with systemd, the command format is `systemctl start chia-@`. For example, if starting a Chia full node for the Linux user `ubuntu`, the command would be: For example, if starting a Chia full node for the Linux user `ubuntu`, the command would be: +To start a Chia process with systemd, the command format is `systemctl start chia-@`. For example, if starting a Chia full node for the Linux user `ubuntu`, the command would be: ``` systemctl start chia-full-node@ubuntu @@ -1406,10 +1037,10 @@ Note that the `chia-timelord` service runs the timelord coordinator service, but ## Troubleshooting -Sometimes stray daemons left over from previously running processes will cause strange bugs/errors when upgrading to a new version. Make sure all daemons and chia processes are killed before installing or upgrading. Make sure all daemons and chia processes are killed before installing or upgrading. +Sometimes stray daemons left over from previously running processes will cause strange bugs/errors when upgrading to a new version. Make sure all daemons and chia processes are killed before installing or upgrading. This is normally done by executing `chia stop -d all` from the upgrade example above. -But it doesn't hurt to double check using `ps -Af | grep chia` to make sure there are no chia processes left running. You may have to manually kill the chia daemon if an install and chia start was performed without first running `chia stop -d all` You may have to manually kill the chia daemon if an install and chia start was performed without first running `chia stop -d all` +But it doesn't hurt to double check using `ps -Af | grep chia` to make sure there are no chia processes left running. You may have to manually kill the chia daemon if an install and chia start was performed without first running `chia stop -d all` If all else fails, rebooting the machine and restarting the chia daemon/processes usually does the trick. @@ -1417,7 +1048,7 @@ If all else fails, rebooting the machine and restarting the chia daemon/processe To join a testnet, follow the instructions on [How to Join the Official Testnet](/testnets#join-the-official-testnet). -It is recommended that you keep a separate testnet environment by prepending `CHIA_ROOT="~/.chia/testnetx"` to all of your cli commands. For example, `CHIA_ROOT="~/.chia/testnet10" chia init`. An easier way to do this is to run `export CHIA_ROOT="~/.chia/testnet10"` so that all commands will use testnet10 instead of mainnet. If you're using a version above 1.2.11, you can update all config values to the testnet values by running `chia configure -t true`. For example, `CHIA_ROOT="~/.chia/testnet11" chia init`. An easier way to do this is to run `export CHIA_ROOT="~/.chia/testnet11"` so that all commands will use testnet11 instead of mainnet. You can update all config values to the testnet values by running `chia configure -t true`. +It is recommended that you keep a separate testnet environment by prepending `CHIA_ROOT="~/.chia/testnetx"` to all of your cli commands. For example, `CHIA_ROOT="~/.chia/testnet11" chia init`. An easier way to do this is to run `export CHIA_ROOT="~/.chia/testnet11"` so that all commands will use testnet11 instead of mainnet. You can update all config values to the testnet values by running `chia configure -t true`. ## Beta and release candidate installations @@ -1435,7 +1066,7 @@ values={[ :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Download chia-blockchain @@ -1462,7 +1093,7 @@ chia init :::note Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: +::: ```bash # Download chia-blockchain @@ -1498,6 +1129,7 @@ values={[ ]}> +```bash # Install packages sudo apt-get update sudo apt-get install ca-certificates curl gnupg @@ -1506,39 +1138,27 @@ sudo apt-get install ca-certificates curl gnupg curl -sL https://repo.chia.net/FD39E6D3.pubkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/chia.gpg # Set up repository -echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/prerelease/debian/ prerelease main" | sudo tee /etc/apt/sources.list.d/chia-blockchain-prerelease.list > /dev/null +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/chia.gpg] https://repo.chia.net/prerelease/debian/ prerelease main" | sudo tee /etc/apt/sources.list.d/chia-blockchain-prerelease.list > /dev/null sudo apt-get update # Install chia-blockchain sudo apt-get install chia-blockchain # Use chia-blockchain-cli instead for CLI only +``` -:::note -Make sure you have [Python 3.10](https://www.python.org/downloads/release/python-3109) and [Git](https://git-scm.com/downloads) installed. -::: - ```bash -# Download chia-blockchain -git clone https://github.com/Chia-Network/chia-blockchain -b latest --recurse-submodules +# Navigate to downloads page +Open https://github.com/Chia-Network/chia-blockchain/releases in a web browser -# Change directory -cd chia-blockchain - -# Checkout the beta or release candidate by tag, tags can be found https://github.com/Chia-Network/chia-blockchain/tags. -git checkout tags/2.1.2-rc2 - -# Install dependencies -sh install.sh - -# Activate virtual environment -. ./activate +# Download the correct asset +Navigate to the release candidate of interest and download the necessary installer for your OS (ex. exe for windows) -# Initialize -chia init +# Install the downloaded installer +Using your system finder/file explorer install the downloaded installer (note - make sure no other versions of chia are installed prior to this step) ``` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md index 929f976ca9..286e8f95af 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/timelords.md @@ -10,7 +10,7 @@ import TabItem from '@theme/TabItem'; **DO NOT** overclock ASICs, overclocking diminishes the life of the ASIC! ::: -Timelord architecture information can be found [here](/timelord-architecture).\ +Timelord architecture information can be found [here](/timelord-architecture). The hw_vdf_client parameter information can be found [here](/asic-cli). --- @@ -18,7 +18,7 @@ The hw_vdf_client parameter information can be found [here](/asic-cli). ## Timelord Requirements and Dependencies :::info -Due to restrictions on how [MSVC](https://en.wikipedia.org/wiki/Microsoft_Visual_C%2B%2B) handles 128 bit numbers and how Python relies upon MSVC, it is not possible to build and run Timelords of all types on Windows.\ +Due to restrictions on how [MSVC](https://en.wikipedia.org/wiki/Microsoft_Visual_C%2B%2B) handles 128 bit numbers and how Python relies upon MSVC, it is not possible to build and run Timelords of all types on Windows. Running a timelord on a farming machine will reduce the efficiency of the farmer and the timelord, for this reason it is recommended to have a dedicated machine for running timelords. ::: @@ -48,14 +48,15 @@ Dependencies: Timelords execute sequential verifiable delay functions (proofs of time or VDFs), that get added to blocks to make them valid. This requires fast CPUs and a few cores per VDF. ::: -\ +]}> + :::info Use `chia-blockchain-cli` instead of `chia-blockchain` for CLI only version that does not have a GUI. ::: @@ -112,7 +113,7 @@ chia start node timelord & :::warning -**DO NOT** overclock ASICs, overclocking diminishes the life of the ASIC!\ +**DO NOT** overclock ASICs, overclocking diminishes the life of the ASIC! Detailed information about the hw_vdf_client parameters can be found [here](/asic-cli). ::: @@ -127,7 +128,7 @@ Main Machine (ASIC 1) -------------------------- (chia node, timelord-only, and ASIC software) \_____ ASIC 3 (ASIC software only, IP set to main machine) ``` -For an ASIC cluster you will need to follow the below install steps on the main machine to include the chia node, timelord-only, and ASIC software processes are all being run on the main machine.\ +For an ASIC cluster you will need to follow the below install steps on the main machine to include the chia node, timelord-only, and ASIC software processes are all being run on the main machine. The additional ASIC hosts will only need the ASIC software installed (noted in the below install instructions). ```bash @@ -160,7 +161,7 @@ chia start node timelord-only ### Installing a Timelord from Source :::info -On MacOS x86_64 and all Linux distributions, building a Timelord is as easy as running `chia start timelord &` in the virtual environment. You can also run `./vdf_bench square_asm 400000` once you've built Timelord to give you a sense of your optimal and unloaded ips. Each run of `vdf_bench` can be surprisingly variable and, in production, the actual ips you will obtain will usually be about 20% lower due to load of creating proofs. The default configuration for Timelords is good enough to just let you start it up. Set your log level to INFO and then grep for "Estimated IPS:" to get a sense of what actual ips your Timelord is achieving.\ +On MacOS x86_64 and all Linux distributions, building a Timelord is as easy as running `chia start timelord &` in the virtual environment. You can also run `./vdf_bench square_asm 400000` once you've built Timelord to give you a sense of your optimal and unloaded ips. Each run of `vdf_bench` can be surprisingly variable and, in production, the actual ips you will obtain will usually be about 20% lower due to load of creating proofs. The default configuration for Timelords is good enough to just let you start it up. Set your log level to INFO and then grep for "Estimated IPS:" to get a sense of what actual ips your Timelord is achieving. Detailed information about the hw_vdf_client parameters can be found [here](/asic-cli). ::: @@ -221,7 +222,7 @@ chia start node timelord-only ## ASIC Timelord Systemd Setup -Below is an example of a systemd service file to run the ASIC hw vdf processes.\ +Below is an example of a systemd service file to run the ASIC hw vdf processes. NOTE - make sure to replace `USERNAME` with your system's username. ```bash diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md index d50a92e9e5..2e86b7f27f 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-appendix.md @@ -12,13 +12,21 @@ In this section we sketch the main building blocks used in the $\textsf{Chia}$  A digital signature scheme is specified by three algorithms; a (probabilistic) key-generation algorithm ${{\sf Sig.keygen}}$, a signing algorithm $\mu\gets {{\sf Sig.sign}}(sk,m)$ and a verification algorithm ${{\sf Sig.verify}}$. We assume the standard security notion (unforgeability under chosen message attacks) and perfect completeness, that is, a correctly generated signature will always verify: -$$ \begin{aligned} \forall m,&& \Pr[{{\sf Sig.verify}}(pk,m,\mu)={\sf accept}]=1\\ -\textrm{where}&&(pk,sk)\gets{{\sf Sig.keygen}}\ ;\ \mu\gets{{\sf Sig.sign}}(sk,m)~. \end{aligned} $$ +$$ +\begin{aligned} +\forall m,&& +\Pr[{{\sf Sig.verify}}(pk,m,\mu)={\sf accept}]=1\\ +\textrm{where}&&(pk,sk)\gets{{\sf Sig.keygen}}\ ;\ \mu\gets{{\sf Sig.sign}}(sk,m)~. +\end{aligned} +$$ $\textsf{Chia}$ uses signatures in the foliage (to chain foliage blocks and to bind them to the trunk) and also in the trunk (so only the farmer can compute the challenge). To avoid grinding attacks, the signatures used in the trunk must be unique, that is for every $pk$ (this includes maliciously generated public keys) and message $m$ there can be at most one accepting signature -$$ \forall pk,m,\ -({{\sf Sig.verify}}(pk,m,\mu)={\sf accept})\wedge ({{\sf Sig.verify}}(pk,m,\mu')={\sf accept})\Rightarrow (\mu=\mu')~. $$ $$ +$$ +\forall pk,m,\ +({{\sf Sig.verify}}(pk,m,\mu)={\sf accept})\wedge +({{\sf Sig.verify}}(pk,m,\mu')={\sf accept})\Rightarrow (\mu=\mu')~. +$$ ## A.2 (Unique) Proofs Of Space @@ -48,18 +56,28 @@ To prevent grinding attacks, we need our PoSpace to be unique as defined below. A PoSpace is unique if for any identity $pk$ and any challenge $c$ there is exactly one proof, i.e., -$$ \begin{aligned} &\forall N,pk,c,\\ -&\left|\{\sigma\ :\ \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\right)\wedge \left( (\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right)\}\right|= 1 \end{aligned} $$ +$$ +\begin{aligned} +&\forall N,pk,c,\\ +&\left|\{\sigma\ :\ \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\right)\wedge \left( (\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right)\}\right|= 1 +\end{aligned} +$$ We call a PoSpace _weakly_ unique if the _expected_ number of proofs is close to $1$, i.e., -$$ \begin{aligned} &\forall N,pk,c,\\ -&{\mathrm E}_{c\gets \{0,1\}^w}\left[|\{\sigma : \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\} \right) \wedge \left((\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right) |\right]\\ -&\approx 1 \end{aligned} $$ +$$ +\begin{aligned} +&\forall N,pk,c,\\ +&{\mathrm E}_{c\gets \{0,1\}^w}\left[|\{\sigma : \left({{\sf PoSpace.verify}}(\sigma)={\sf accept}\} \right) +\wedge \left((\sigma.N,\sigma.pk,\sigma.c)=(N,pk,c)\right) +|\right]\\ +&\approx 1 +\end{aligned} +$$ For weakly unique PoSpace we assume that whenever there is more than one proof for a given challenge which passes verification, ${\sf PoSpace.prove}(S,c)$ outputs all of them. -The [AAC+17] PoSpace used in $\textsf{Chia}$ is only _weakly unique_. To be able to focus on the main challenges, we will nonetheless assume a _unique_ PoSpace when analyzing $\textsf{Chia}$ but our analysis can be extended without major difficulties to handle weakly unique PoSpace, things just get a bit more messy. To be able to focus on the main challenges, we will nonetheless assume a _unique_ PoSpace when analyzing $\textsf{Chia}$ but our analysis can be extended without major difficulties to handle weakly unique PoSpace, things just get a bit more messy. +The [AAC+17] PoSpace used in $\textsf{Chia}$ is only _weakly unique_. To be able to focus on the main challenges, we will nonetheless assume a _unique_ PoSpace when analyzing $\textsf{Chia}$ but our analysis can be extended without major difficulties to handle weakly unique PoSpace, things just get a bit more messy. ### A.2.4 The [AAC+17] PoSpace @@ -67,11 +85,16 @@ We give a very high level outline of the PoSpace from [Pie19b; Wes20] VDFs discussed below also $\tau.\pi$ is unique. -**sequentiality:** Informally, sequentiality states that for any $t$, an adversary ${\cal A}$ who makes less than $t$ sequential steps will not find an accepting proof on a random challenge. I.e., for some tiny $\epsilon$ +**sequentiality:** +Informally, sequentiality states that for any $t$, an adversary ${\cal A}$ who makes less than $t$ sequential steps will not find an accepting proof on a random challenge. I.e., for some tiny $\epsilon$ -$$ \hspace{-1cm} \Pr[{\sf VDF.verify}(\tau)={\sf accept}\ \wedge \ \tau.c=c\ \wedge\ \tau.t=t \ :\ c\stackrel{rand}{\gets}\{0,1\}^w,\tau\gets{\cal A}(c,t)]\le \epsilon $$ +$$ +\hspace{-1cm} + \Pr[{\sf VDF.verify}(\tau)={\sf accept}\ \wedge \ \tau.c=c\ \wedge\ \tau.t=t \ :\ c\stackrel{rand}{\gets}\{0,1\}^w,\tau\gets{\cal A}(c,t)]\le \epsilon +$$ Let us stress that ${\cal A}$ is only bounded by the number of _sequential_ steps, but they can use high parallelism. Thus the VDF output cannot be computed faster by adding parallelism beyond what can be used to speed up a single step of the VDF computation. ### A.3.1 The [Pie19b, Wes20] VDFs -The VDFs proposed in \[Pie19b; Wes20\] (see [BBBF18a] for an overview of those constructions) are both based on squaring in a group of unknown order, for concreteness let the group be $\mathbb{Z}_N^*$ where $N=pq$ is the product of two large primes $p,q$. On input ${\sf VDF.solve}(c,t)$ one would first map the challenge $c$ on a group element, say as $x_c:= hash(c)\bmod N$, and the output is $(y,\pi)$ with $y=x_c^{2^t}\bmod N$. This $y$ can be computed by squaring $x_c$ sequentially $t$ times $x_c\rightarrow x_c^2\rightarrow x_c^{2^2}\rightarrow \cdots \rightarrow x_c^{2^t}$, and it is conjectured that there is no shortcut to this computation if one doesn't know the factorization of $N$. +The VDFs proposed in [Pie19b; Wes20] (see [BBBF18a] for an overview of those constructions) are both based on squaring in a group of unknown order, for concreteness let the group be $\mathbb{Z}_N^*$ where $N=pq$ is the product of two large primes $p,q$. On input ${\sf VDF.solve}(c,t)$ one would first map the challenge $c$ on a group element, say as $x_c:= hash(c)\bmod N$, and the output is $(y,\pi)$ with $y=x_c^{2^t}\bmod N$. This $y$ can be computed by squaring $x_c$ sequentially $t$ times $x_c\rightarrow x_c^2\rightarrow x_c^{2^2}\rightarrow \cdots \rightarrow x_c^{2^t}$, and it is conjectured that there is no shortcut to this computation if one doesn't know the factorization of $N$. The VDFs from [Pie19b; Wes20] differ in how the proof $\pi$ that certifies that $y=x_c^{2^t}\bmod N$ is defined. The proof in [Pie19b] is shorter ($1$ vs. $\log(T)$ elements), but soundness of the proof requires an additional assumption (that taking random roots is hard). diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md index e4c010e737..a700077553 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/hash-and-vdf-chains.md @@ -12,7 +12,9 @@ A key ingredient in longest-chain blockchains are hash-chains as discussed in § For this writeup, a _hash chain_ is a sequence $b_0,b_1,b_2\ldots$ of blocks, where each block $b_i=\{h_i,x_i\}$ contains some data value $x_i$ (possibly empty) and (with the exception of $b_0$) a hash value of the current data and the previous block. -$$ h_i:={\sf H}(b_{i-1},x_i) $$ +$$ +h_i:={\sf H}(b_{i-1},x_i) +$$ #### Security from hash chains. @@ -20,21 +22,22 @@ A hash chain is immutable in the following sense: --- -**Proposition 2** (immutability of hash chains). **Proposition 2** (immutability of hash chains). _If ${\sf H}$ is a collision-resistant hash function, then it is computationally infeasible to find two distinct hash chains ${\cal H}=b_0,\ldots.b_i$ and ${\cal H'}=b'_0,\ldots,b'_j$ where $h_i=h'_j$ and no chain is a prefix of the other (which holds if they start with the same $x_0=x'_0$)._ +**Proposition 2** (immutability of hash chains). _If ${\sf H}$ is a collision-resistant hash function, then it is computationally infeasible to find two distinct hash chains ${\cal H}=b_0,\ldots.b_i$ and ${\cal H'}=b'_0,\ldots,b'_j$ where $h_i=h'_j$ and no chain is a prefix of the other (which holds if they start with the same $x_0=x'_0$)._ --- ## 4.2 VDF chains
- Illustration of a VDF chain -
Figure 6: Illustration of a VDF chain.
+ Illustration of a VDF chain +
Figure 6: Illustration of a VDF chain.
A VDF chain is a sequence $$ -{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell $$ +{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell +$$
eq.(5)
@@ -46,13 +49,15 @@ $$ and the challenge for the $i$th VDF is derived from the previous VDF output (except for $i=1$) and data value -$$ \tau_1.c := \mathsf{VDF.sample}(z_0) \quad \text{ and } \quad \forall i > 1 : \tau_i.\mathsf{c} := \mathsf{VDF.sample}(\tau_{i-1}.\mathsf{y}, z_{i-1}) $$ +$$ +\tau_1.c := \mathsf{VDF.sample}(z_0) \quad \text{ and } \quad \forall i > 1 : \tau_i.\mathsf{c} := \mathsf{VDF.sample}(\tau_{i-1}.\mathsf{y}, z_{i-1}) +$$ where we use the convention that $\tau_0.{\sf y}$ is the empty string. ### 4.2.1 Notation for VDF chains -We naturally extend the notion for VDFs as described in §A.3 to VDF chains. We naturally extend the notion for VDFs as described in §A.3 to VDF chains. The _total number of VDF steps in a VDF chain_ as in eq.(5) is simply the sum of the steps in its VDFs +We naturally extend the notion for VDFs as described in §A.3 to VDF chains. The _total number of VDF steps in a VDF chain_ as in eq.(5) is simply the sum of the steps in its VDFs $$ {\cal V}.{\sf t}\stackrel{\scriptsize \sf def}{=}\sum_{i=1}^\ell \tau_i.{\sf t} @@ -64,15 +69,16 @@ VDF chains give two basic security guarantees, the first is immutability analogo --- -**Proposition 3** (immutability and sequentiality of VDF chains). **Proposition 3** (immutability and sequentiality of VDF chains). *Like a hash chain, a VDF chain is *immutable* in the sense that it's computationally infeasible to come up with two different VDF chains* +**Proposition 3** (immutability and sequentiality of VDF chains). *Like a hash chain, a VDF chain is *immutable* in the sense that it's computationally infeasible to come up with two different VDF chains* $$ -{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell \qquad -{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell \qquad {\cal V}'=z'_0,\tau'_1,z'_1,\tau'_2,z'_2,\ldots,\tau'_{\ell'} +{\cal V}=z_0,\tau_1,z_1,\tau_2,z_2,\ldots,\tau_\ell +\qquad +{\cal V}'=z'_0,\tau'_1,z'_1,\tau'_2,z'_2,\ldots,\tau'_{\ell'} $$ -where the last VDF outputs collide, i.e., $\tau_\ell.{\sf y}=\tau'_{\ell'}.{\sf y}$. Here different means that either they have different length $\ell\neq \ell'$ and neither is a prefix of the other. Or (if $\ell=\ell'$) there exists an $i$ s.t. either $z_i\neq z'_i$ or $\tau_i.{\sf y}\neq \tau'_i.{\sf y}$ or $\tau.{\sf t}\neq \tau'.{\sf t}$. Note that we ignore the proofs $\tau.\pi$ when comparing chains (we just use them to determine whether the chain is valid) as they must not be unique. Here different means that either they have different length $\ell\neq \ell'$ and neither is a prefix of the other. Or (if $\ell=\ell'$) there exists an $i$ s.t. either $z_i\neq z'_i$ or $\tau_i.{\sf y}\neq \tau'_i.{\sf y}$ or $\tau.{\sf t}\neq \tau'.{\sf t}$. Note that we ignore the proofs $\tau.\pi$ when comparing chains (we just use them to determine whether the chain is valid) as they must not be unique. +where the last VDF outputs collide, i.e., $\tau_\ell.{\sf y}=\tau'_{\ell'}.{\sf y}$. Here different means that either they have different length $\ell\neq \ell'$ and neither is a prefix of the other. Or (if $\ell=\ell'$) there exists an $i$ s.t. either $z_i\neq z'_i$ or $\tau_i.{\sf y}\neq \tau'_i.{\sf y}$ or $\tau.{\sf t}\neq \tau'.{\sf t}$. Note that we ignore the proofs $\tau.\pi$ when comparing chains (we just use them to determine whether the chain is valid) as they must not be unique. -Moreover a VDF chain is _sequential_, meaning that not only the individual VDFs must be computed sequentially (which follows from the security definition of VDFs), but also the VDFs in the chain were computed sequentially. I.e., computing a chain ${\cal V}$ as above requires $\sum_{i=1}^\ell \tau_i.{\sf t}$ sequential steps. I.e., computing a chain ${\cal V}$ as above requires $\sum_{i=1}^\ell \tau_i.{\sf t}$ sequential steps. +Moreover a VDF chain is _sequential_, meaning that not only the individual VDFs must be computed sequentially (which follows from the security definition of VDFs), but also the VDFs in the chain were computed sequentially. I.e., computing a chain ${\cal V}$ as above requires $\sum_{i=1}^\ell \tau_i.{\sf t}$ sequential steps. --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md index 8b20242a42..42ab5f8a46 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/recovering-from-51-percent-attacks.md @@ -14,10 +14,10 @@ We discussed in §2 the main security issues of a PoSpace based longest-chain b
- ![](/img/green-paper/table-1.png)
- Table 1: Summary of the ability to heal from malicious majority and provide security under dynamic availability of longest-chain protocols based various proof systems. -
+ Table 1: Summary of the ability to heal from malicious majority and provide + security under dynamic availability of longest-chain protocols based various + proof systems.
@@ -31,20 +31,21 @@ There's also a key difference between PoStake and PoSpace. By using VDFs in addi While Bitcoin provides no security if more than half of the hashrate is controlled by an adversary, it is "self-healing" in the sense that once the majority of the hashrate is again controlled by honest parties, Bitcoin regains (after some delay) all its security properties. -A bit more formally, let ${\sf PoW}_h(t)$ and ${\sf PoW}_a(t)$ denote the hashing power of the honest and adversarial parties at clock time $t$, respectively. For $t_0 - -eq.(11)
@@ -52,8 +53,12 @@ If this holds the adversary can simply start at time $t_0$ to mine a chain in pr To be secure it's not sufficient that no $t_0,t_1$ as in eq.(11) exist, but one needs to be "sufficiently far" from this situation to guarantee that double spending can only happen with some tiny probability. From the standard Chernoff bound it follows that the probability that a fork starting at a block added at time $t_0$ and being released at time $t_1$ will be successful (i.e., have higher weight than the honest chain) is exponentially small in the number of expected honest blocks ${\sf PoW}_h(t_0,t_1)/D$ and the square of the honest to adversarial advantage, i.e., -$$ \begin{aligned} &\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ -&\le -\exp\left(\frac{\mathsf{PoW}_h(t_0,t_1)}{D} \cdot\left( \frac{\mathsf{PoW}_h(t_0,t_1)}{\mathsf{PoW}_a(t_0,t_1)}-1 \right)^2\right) \end{aligned} $$ +$$ +\begin{aligned} +&\text{Pr}\left[\text{fork starting at } t_0 \text{ and released at } t_1 \text{ heavier than honest chain}\right] \\ +&\le -\exp\left(\frac{\mathsf{PoW}_h(t_0,t_1)}{D} \cdot\left( \frac{\mathsf{PoW}_h(t_0,t_1)}{\mathsf{PoW}_a(t_0,t_1)}-1 \right)^2\right) +\end{aligned} +$$
eq.(12)
@@ -69,11 +74,11 @@ A longest-chain protocol using only PoSpace (like Spacemint [eq.(6)
@@ -106,17 +116,22 @@ The reward chain ${\cal RC}$ is a VDF chain that the time lords evaluate in para Whenever a farmer receives new signage points ${\sf cc\_sp}_{i,j},{\sf rc\_sp}_{i,j}$ they first check whether this points lie on a heaviest chain (cf. the discussion in §1.5) and their VDF proofs verify. If the this is the case, the farmer checks they can create a winning PoSpace proof. This process will, for a subset of the plots, produce a PoSpace $\sigma$ and some additional value $\sigma.{\sf required\_iterations}$. Whether this PoSpace is a winning proof is now determined by the time parameter $T_i$ as -$$ \textrm{winning condition : } \sigma.{\sf required\_iterations} < {\sf spi}_i\quad (=T_i/64) $$ +$$ +\textrm{winning condition : } +\sigma.{\sf required\_iterations} < {\sf spi}_i\quad (=T_i/64) +$$
eq.(7)
:::tip Design Choice 2: Why 32 Blocks in Expectation and not Exactly? -With our winning condition we have 32 blocks per slot _in expectation_ depending on a challenge. We could have used a different design to enforce _exactly_ 32 challenges, but then it would be impossible to achieve our Objective 1.(c), which asks that whether a plot wins must depend solely on the challenge. ::: We could have used a different design to enforce _exactly_ 32 challenges, but then it would be impossible to achieve our Objective 1.(c), which asks that whether a plot wins must depend solely on the challenge. +With our winning condition we have 32 blocks per slot _in expectation_ depending on a challenge. We could have used a different design to enforce _exactly_ 32 challenges, but then it would be impossible to achieve our Objective 1.(c), which asks that whether a plot wins must depend solely on the challenge. ::: If a farmer has a winning PoSpace $\sigma$ they can produce a block $\beta=(\beta_T,\beta_F)$ which contains the foliage block $\beta_F$ and the trunk block $\beta_T$. The actual $\textsf{Chia}$ blocks are more sophisticated than our description below, but in this writeup we focus on the entries which are absolutely necessary for functionality and security of the chain and ignore entries which are there for efficiency like weight proofs for light clients or pooling. They key entries in a valid trunk block -$$ \beta_T=(\sigma,\mu_{{{\sf rc\_sp}}}) $$ +$$ +\beta_T=(\sigma,\mu_{{{\sf rc\_sp}}}) +$$ are @@ -129,19 +144,22 @@ $\mu_{\sf rc\_sp}\gets {{\sf Sig.sign}}(S.sk,{\sf rc\_sp}_{i,j})$, a signature u The reward chain ${\cal RC}$ is a VDF chain that time lords compute in parallel to ${\cal CC}$. Like ${\cal CC}$, ${\cal RC}$ can be spilt in a sequence of slots. $$ -{\cal RC}={\cal RC}_1,{\cal RC}_2,\ldots $$ +{\cal RC}={\cal RC}_1,{\cal RC}_2,\ldots +$$ While in ${\cal CC}$ the $i$th slot just contains a VDF $\tau^{\cal CC}_i$ and the value ${\sf ic}_i$ infused at the end, each slot ${\cal RC}_i$ of the ${\cal RC}$ chain $$ -{\cal RC}_i=\tau^{\cal RC}_{i,1},\beta_1,\tau^{\cal RC}_{i,2},\beta_2\ldots, \beta_{b_i} \tau^{\cal RC}_{i,b_i+1},({\sf ic}_i,\tau^{\cal CC}_{i}.{\sf y}) $$ +{\cal RC}_i=\tau^{\cal RC}_{i,1},\beta_1,\tau^{\cal RC}_{i,2},\beta_2\ldots, \beta_{b_i} \tau^{\cal RC}_{i,b_i+1},({\sf ic}_i,\tau^{\cal CC}_{i}.{\sf y}) +$$
eq.(8)
is a VDF chain with typically around $33$ infused values: around 32 blocks $b_i$ and at the end of the slot also the ${\cal CC}$ and ${\sf i}{\cal CC}$ points at the same depth. The ${\cal RC}$ signage points are $$ -{\sf rc\_sp}_{i,j}\stackrel{\scriptsize \sf def}{=}{\cal RC}_i[j\cdot {\sf spi}_i] $$ +{\sf rc\_sp}_{i,j}\stackrel{\scriptsize \sf def}{=}{\cal RC}_i[j\cdot {\sf spi}_i] +$$
eq.(9)
@@ -164,21 +182,29 @@ Recall that the challenge chain ${\cal CC}$ is used to create PoSpace challenges Concretely, the infused challenge of the $i$th slot is the output of a VDF computation $$ -{\sf ic}_i\stackrel{\scriptsize \sf def}{=}\tau.{\sf y}\qquad \tau={\sf VDF.solve}(x,t) $$ +{\sf ic}_i\stackrel{\scriptsize \sf def}{=}\tau.{\sf y}\qquad \tau={\sf VDF.solve}(x,t) +$$ on some challenge $x$ and time $t$ which are defined as follows. Let $\beta_T=(\sigma,\mu_{{{\sf rc\_sp}}})$ be the first trunk block infused into the $i$th slot ${\cal RC}_i$ past the 3rd signage point, using notion as in eq.(10) -$$ \beta_T=\beta_j \textrm{ where }j=\min\{k\ :\ \beta_k.{\sf d}>3\cdot {\sf spi}\} $$ +$$ +\beta_T=\beta_j \textrm{ where }j=\min\{k\ :\ \beta_k.{\sf d}>3\cdot {\sf spi}\} +$$ now the challenge $x$ is derived from the PoSpace in this block and the value of ${\cal CC}$ at the depth of its infusion point -$$ \quad x\gets {\sf VDF.sample}(\sigma,{\cal CC}[{\sf rc\_ip}(\beta_T).{\sf D}].{\sf y}) $$ +$$ +\quad +x\gets {\sf VDF.sample}(\sigma,{\cal CC}[{\sf rc\_ip}(\beta_T).{\sf D}].{\sf y}) +$$ the number of steps $t$ is the the remaining number of VDF steps in the slot, so the value ${\sf ic}_i$ will be available at the end of the slot when it's required, but not earlier -$$ t={\sf cc\_ip}_{i,0}.{\sf D}- {\sf rc\_ip}(\beta).{\sf D} $$ +$$ +t={\sf cc\_ip}_{i,0}.{\sf D}- {\sf rc\_ip}(\beta).{\sf D} +$$ :::danger Security Notice 1: Why iCC depends only on σ We only use $\sigma$, not the entire trunk block $\beta_T=(\sigma,\mu_{{{\sf rc\_sp}}})$, to compute the infused challenge ${\sf ic}_i$. This is crucial to ensure that the challenges depend only on a single challenge per slot. Had we infused the entire $\beta_T$ (as we do into ${\cal RC}$), the challenges would depend on all blocks (as $\mu_{{\sf rc\_sp}}$ depends on ${\cal RC}$ which infuses all blocks) and we would not get security against double dipping. @@ -206,11 +232,15 @@ To limit the impact of double-dipping we use correlated randomness [
-
Once you have a synced wallet and some TXCH, you are ready to run the CAT admin tool. @@ -97,7 +96,7 @@ values={[ ]}> -Your Linux installation may not come with Python's development tools installed by default. Your Linux installation may not come with Python's development tools installed by default. To be sure that these tools are installed, run: +Your Linux installation may not come with Python's development tools installed by default. To be sure that these tools are installed, run: ```bash sudo apt-get install -y build-essential python3-dev @@ -145,31 +144,6 @@ pip install chia-dev-tools --no-deps Install pytest: -```bash -pip install pytest -``` ./venv/bin/activate -``` - -Install the prerequisites: - -```bash -python3 -m pip install --upgrade pip setuptools wheel -``` - -Install the tool: - -```bash -pip install . -``` - -Install chia dev tools: - -```bash -pip install chia-dev-tools --no-deps -``` - -Install pytest: - ```bash pip install pytest ``` @@ -226,23 +200,6 @@ pip install pytest :::note You might receive an error such as ERROR: Failed building wheel for CAT-admin-tool. This is likely safe to ignore. As long as you can run cats --help without errors, the tool has been installed properly. ::: -``` - -Install Chia dev tools: - -```bash -pip install chia-dev-tools --no-deps -``` - -Install pytest: - -```bash -pip install pytest -``` - -:::note -You might receive an error such as ERROR: Failed building wheel for CAT-admin-tool. This is likely safe to ignore. As long as you can run cats --help without errors, the tool has been installed properly. -::: @@ -250,7 +207,7 @@ You might receive an error such as ERROR: Failed building wheel for CAT-admin-to ---
- + Your environment should be all set, but let's make sure: - Run `cats --help`. You should get a usage statement. @@ -267,7 +224,7 @@ To get started, you will create a single-issuance CAT. This is the default way t :::note -A TAIL is a Chialisp program that defines the rules for issuing and melting tokens. Learn more about the [Token and Asset Issuance Limitations program](https://chialisp.com/cats/#tail). Learn more about the [Token and Asset Issuance Limitations program](https://chialisp.com/cats/#tail). +A TAIL is a Chialisp program that defines the rules for issuing and melting tokens. Learn more about the [Token and Asset Issuance Limitations program](https://chialisp.com/cats/#tail). ::: @@ -275,7 +232,7 @@ A CAT with a single-issuance TAIL will be useful for anyone who wants to create First, figure out how many tokens you want to issue. Because creating a single token takes 1,000 mojos, you will multiply your supply by 1,000 to figure out how much TXCH (or XCH on mainnet) is needed. For example, if you want to issue 1 million tokens, you'll need 1 billion mojos (1/1000 of a TXCH/XCH). -Take note of your _Receive Address_ in the Chia GUI. (Alternatively, run `chia wallet get_address` from a terminal window.) You'll need this address for the next step. (Alternatively, run `chia wallet get_address` from a terminal window.) You'll need this address for the next step. +Take note of your _Receive Address_ in the Chia GUI. (Alternatively, run `chia wallet get_address` from a terminal window.) You'll need this address for the next step. After confirming you are within the admin tool directory, run: @@ -323,7 +280,7 @@ First, figure out how many tokens you want to issue. Because creating a single t Just as with the Single Issuance CAT, we recommend that you include a fee with your transaction. This fee will ensure that your transaction is processed in front of any dust in the mempool. Whether you're running on testnet or mainnet, the recommended fee amount is 100 million mojos (`-m 100000000`). Even though you will run the `cats` command multiple times, the fee will only be applied once, when the transaction is pushed to the network. ::: -Run `chia wallet get_address` from a terminal window to get a new receive address. You will use this address shortly. You will use this address shortly. +Run `chia wallet get_address` from a terminal window to get a new receive address. You will use this address shortly. Run `chia keys show`. Take note of your **fingerprint** and **master public key**. @@ -382,7 +339,6 @@ Now you can add a wallet ID for your new CAT. In the lower left corner, click `M
Manage Token List
-
The first few tokens listed will be there by default (Marmot, Spacebucks, etc). At the end of the list, you should find your CAT's `asset ID`. Feel free to rename your CAT, and click the slider to add a new wallet with that CAT: @@ -390,7 +346,6 @@ The first few tokens listed will be there by default (Marmot, Spacebucks, etc).
Enable new CAT
-
You will now see your token in your wallet with the full issued quantity. As a reminder, this should be the number of mojos spent divided by 1,000 (as each CAT token requires 1,000 mojos to issue). @@ -398,7 +353,6 @@ You will now see your token in your wallet with the full issued quantity. As a r
View new CAT
-
You now have access to your CAT in the GUI. You can send and receive your new tokens just like you would with regular XCH. @@ -415,7 +369,7 @@ When you are ready to issue your CAT to mainnet, the first step is to switch to chia configure -t false ``` -The second step is to generate a new key pair and store the mnemonic in a secure manner. The second step is to generate a new key pair and store the mnemonic in a secure manner. You can generate your key by clicking `Add Wallet` and `Create New` from the `Wallet Keys` login screen of the GUI. This will work in the same manner as earlier for our testnet CAT. This will work in the same manner as earlier for our testnet CAT. +The second step is to generate a new key pair and store the mnemonic in a secure manner. You can generate your key by clicking `Add Wallet` and `Create New` from the `Wallet Keys` login screen of the GUI. This will work in the same manner as earlier for our testnet CAT. :::danger We recommend the new keypair being used exclusively for the CAT ownership. @@ -428,7 +382,9 @@ This would be a complex and time-consuming process that would likely result in p ::: :::tip -You can generate keys from the CLI as well. Use `chia keys show` to see your available keys. Take note of their fingerprint as you will want to _not_ use an existing key. Generate a key with `chia keys generate`, followed by `chia keys show --show-mnemonic-seed` to reveal the 24 words. +You can generate keys from the CLI as well. +Use `chia keys show` to see your available keys. Take note of their fingerprint as you will want to _not_ use an existing key. +Generate a key with `chia keys generate`, followed by `chia keys show --show-mnemonic-seed` to reveal the 24 words. ::: Copy your new key pair's **mnemonic seed (24 secret words)** to a secure offline location. These 24 words are all you'll need to restore your wallet in the future. @@ -439,6 +395,6 @@ Finally, you can go through the same process to create a CAT now using real XCH Congratulations! You've created your first CAT. What now? -Well, hopefully you can share your CAT with the world and get some traction. Well, hopefully you can share your CAT with the world and get some traction. In the meantime, you can learn more about the [Single Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/genesis_by_coin_id.clsp) and [Multi Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/delegated_tail.clsp). +Well, hopefully you can share your CAT with the world and get some traction. In the meantime, you can learn more about the [Single Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/genesis_by_coin_id.clsp) and [Multi Issuance TAIL](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/cat_wallet/puzzles/delegated_tail.clsp). This guide was for fungible tokens. Now you can learn about [non-fungible tokens](/guides/nft-intro). diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md index 9a37338603..026f0660f6 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md @@ -64,7 +64,6 @@ python -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` @@ -73,7 +72,6 @@ python3 -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` @@ -624,7 +622,6 @@ values={[ ```powershell cats --tail .\reference_tails\delegated_tail.clsp.hex --curry 0x8a7afe10d00899b94cf0d407b85e1b9fca21868bcf158563fe9432b60e36db7136055186221fbd27ecc7fc0d5b99ef1b --send-to xch1rd7hejemt57amqtxq8azqg90hgxyhd9shwyjuppq5ez2jn4rlznscn4efy --amount 6000000000 --as-bytes --solution "(a (q 2 (i 47 (q 8) (q 2 (i (= 45 2) () (q 8)) 1)) 1) (c (q . 0x11038a7e107cb7e17a503ba201d94166018deecd777314e4697c5269d9f37fb6) 1))" --signature b75390ee21b001b7a721f719ff045e3dc2a1072ab0824a8e75c881398db0fbed8fde5c62bbdfe629dce5da3d77834559016acd6d403f9b90d3102da2e9452461457514088af0cabe0b8a8493fc9c09d1785f1322abc8958ecf7907eba0e0abcc -``` 0x11038a7e107cb7e17a503ba201d94166018deecd777314e4697c5269d9f37fb6) 1))" --signature b75390ee21b001b7a721f719ff045e3dc2a1072ab0824a8e75c881398db0fbed8fde5c62bbdfe629dce5da3d77834559016acd6d403f9b90d3102da2e9452461457514088af0cabe0b8a8493fc9c09d1785f1322abc8958ecf7907eba0e0abcc ``` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md index e6e2e341fa..e8c6538d78 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-snapshot.md @@ -44,18 +44,17 @@ values={[ ]}> -1. If you previously installed Chia from a **binary build**, then set up an alias to the `chia` command: +- If you previously installed Chia from a **binary build**, then set up an alias to the `chia` command: :::caution Ensure that you replace `` and `` with the actual folders - -::: +::: ```powershell Set-Alias -Name chia "C:\Users\\AppData\Local\chia-blockchain\app-\resources\app.asar.unpacked\daemon\chia.exe" ``` -2. If you previously installed Chia **from source**, then navigate to the `chia-blockchain` directory and activate your virtual environment: +- If you previously installed Chia **from source**, then navigate to the `chia-blockchain` directory and activate your virtual environment: ```powershell .\venv\Scripts\Activate.ps1 @@ -66,29 +65,25 @@ Set-Alias -Name chia "C:\Users\\AppData\Local\chia-blockchain\app- -1. If you previously installed Chia from a **binary build**, then set up an alias to the `chia` command: +- If you previously installed Chia from a **binary build**, then set up an alias to the `chia` command: ```bash alias chia="/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon/chia" ``` -2. If you previously installed Chia **from source**, then navigate to the `chia-blockchain` directory and activate your virtual environment: +- If you previously installed Chia **from source**, then navigate to the `chia-blockchain` directory and activate your virtual environment: ```bash . ./activate -``` ./activate ``` @@ -115,8 +110,9 @@ alias chia="/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon/c 3. `START_HEIGHT` - The height of the blockchain to start creating the snapshot from (default: `0`). If you are attempting to obtain all records for your CAT, the recommended start height is `1146800`, which is just before CAT1 was introduced. 4. `TARGET_HEIGHT` - The height of the blockchain to end the snapshot (no default - must be set). The recommended height is `2311760`, which is the last block at which CAT1 is valid. - :::caution Running this process with the recommended block heights could take over 40 hours to complete. You may wish to test it first by setting the `TARGET_HEIGHT` to `1146900`. This will pull data from only 100 blocks, which should only take a few seconds. -::: + :::caution + Running this process with the recommended block heights could take over 40 hours to complete. You may wish to test it first by setting the `TARGET_HEIGHT` to `1146900`. This will pull data from only 100 blocks, which should only take a few seconds. + ::: In order to set these variables, you are recommended to put them into a file called `.env` at the root of the `CAT-addresses` project. The tool will automatically read the variables in this file. For example: @@ -196,7 +192,6 @@ python3 setup.py install :::note The result may contain several warnings such as `WARNING: The wheel package is not available.` These can be safely ignored. ::: -::: This command may take a few minutes to complete. At the end of the output, you should see something like: @@ -247,7 +242,6 @@ python3 setup_database.py :::tip If you receive an error message such as `ModuleNotFoundError: No module named 'chia'`, then make sure you can run the `chia` command from this directory and try again. ::: -::: If this command succeeds, then it will output: @@ -292,7 +286,7 @@ python3 start.py This command will show its progress according to the block height. If you used the recommended range for `START_HEIGHT` and `TARGET_HEIGHT` in your `.env` file, then this command could take over 40 hours to complete. The reason it takes so long is it needs to process each block, one at a time. If multiple blocks were done in parallel, then there would be a chance that the results would not be accurate. By processing one block at a time, the tool will return the correct results for the range provided. :::note -You can only generate a snapshot for each block once. If you attempt to run this command over a range against which it has already been run, you will receive an error containing this message: If you attempt to run this command over a range against which it has already been run, you will receive an error containing this message: +You can only generate a snapshot for each block once. If you attempt to run this command over a range against which it has already been run, you will receive an error containing this message: ``` sqlite3.IntegrityError: UNIQUE constraint failed: coin_create.coin_name @@ -379,10 +373,10 @@ python3 export.py --output-dir /Users/Username/CAT-addresses/results/CKC_ --tail - `` - a string to be prepended to the output file name - `` - the TAIL hash you obtained from taildatabase.com - `--coins` - an **optional** flag that will add information about individual coins to the output (which might be helpful for auditing purposes) -::: + ::: :::note -This command will not create any directories, so make sure `` already exists before running it. Otherwise, you will receive a `FileNotFoundError`. ::: Otherwise, you will receive a `FileNotFoundError`. +This command will not create any directories, so make sure `` already exists before running it. Otherwise, you will receive a `FileNotFoundError`. ::: ## Fix EOL Characters {#fix-eol} diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md index 8307fd3a2d..ee81b6d1db 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cr-cat-tutorial.md @@ -53,7 +53,6 @@ It is possible to brick\* funds by sending them to an address without the approp \* Technically, the funds will remain recoverable, but this process will not be easy. ::: -::: ### DID and VC Setup @@ -135,7 +134,6 @@ The VC is also viewable from the GUI:
Authorized provider VC
-
#### VC Holder Wallet @@ -183,7 +181,6 @@ The VC is also viewable from the GUI:
Holder VC
-
#### XCH Wallet @@ -249,19 +246,6 @@ python3 -m pip install --upgrade pip setuptools wheel Install the CAT admin tool: -```bash -pip install . -``` ./venv/bin/activate -``` - -Install all prerequisites: - -```bash -python3 -m pip install --upgrade pip setuptools wheel -``` - -Install the CAT admin tool: - ```bash pip install . ``` @@ -303,7 +287,6 @@ Install the CAT admin tool: ```bash pip install . -``` ``` @@ -388,7 +371,6 @@ Response (truncated): ```bash ... -... Profile 1: -Total Balance: 1.0 -Pending Total Balance: 1.0 @@ -478,7 +460,6 @@ Response (truncated): ```bash ... -... CAT 3ba9e16dca39f3fb...: -Total Balance: 1000.0 (1000000 mojo) -Balance Pending VC Approval: 0.0 (0 mojo) @@ -497,7 +478,6 @@ This information is also viewable in the GUI:
CR-CAT issuance
-
The Authorized Provider now has control of all 1000 of the issued CR-CATs. This type of CAT is distinguished in the GUI by a padlock icon and `Restricted CAT`. The Authorized Provider now has control of all 1000 of the issued CR-CATs. This type of CAT is distinguished in the GUI by a padlock icon and `Restricted CAT`. The Authorized Provider also possesses a VC with the required proof (`test_proof1`), so a green icon appears when viewing the CAT. @@ -513,7 +493,6 @@ You can send CR-CATs just as you would with regular CATs:
CR-CAT send
-
You should see a "success" message: @@ -521,7 +500,6 @@ You should see a "success" message:
CR-CAT send success
-
In this example, the recipient is the VC Holder's wallet. This wallet holds the credential with the required proof (`test_proof1`) for holding this CR-CAT. Because the proof exists, a green `APPROVE` button will appear. @@ -531,7 +509,6 @@ From the VC Holder's wallet, click this button to finalize the transaction:
VC Holder Approve
-
An on-chain transaction is required for the approval to be processed. An on-chain transaction is required for the approval to be processed. This is necessary to guard against unauthorized wallets holding CR-CATs, as will be demonstrated later in this tutorial. Enter a transaction fee and click `APPROVE PENDING TRANSACTIONS`: Enter a transaction fee and click `APPROVE PENDING TRANSACTIONS`: @@ -539,7 +516,6 @@ An on-chain transaction is required for the approval to be processed. An on-chai
Approve pending transactions
-
After the transaction has been processed, the CR-CATs will become available to the VC Holder, who can now send or trade them just like normal CATs. @@ -547,7 +523,6 @@ After the transaction has been processed, the CR-CATs will become available to t
CR-CAT approved
-
### Sending from the CLI @@ -580,7 +555,6 @@ Response: ```bash Submitting transaction... -Submitting transaction... Transaction submitted to nodes: [{'peer_id': 'b3d9de85d29931c10050b56c7afb91c99141943fc81ff2d1a8425e52be0d08ab', 'inclusion_status': 'SUCCESS', 'error_msg': None}] Run 'chia wallet get_transaction -f 3152280463 -tx 0xab577bdce7fdd1be8b4e0634ad69aa5cff66f6d9dc7d26e0119d1a3a740f91e8' to get status ``` @@ -599,8 +573,6 @@ Status: Confirmed Amount sent: 100 CAT 3ba9e16dca39f3fb... To address: txch1yzjq802ym3lv9aupl6nyvv6s24fdm9wpnte2rvhk04arr3jyt4js2287gz Created at: 2023-09-22 09:21:25 -To address: txch1yzjq802ym3lv9aupl6nyvv6s24fdm9wpnte2rvhk04arr3jyt4js2287gz -Created at: 2023-09-22 09:21:25 ``` **After switching to the VC Holder's wallet**, you should see the CR-CATs that are pending approval (in this case `100.0 (100000 mojo)`): @@ -697,7 +669,6 @@ In this example, as the **Authorized Provider**, click `CREATE AN OFFER` from th
Create an Offer
-
Next, fill out the Offer Builder. Next, fill out the Offer Builder. For this example, we will offer to trade 99 CR-CATs for 0.1 TXCH: @@ -705,7 +676,6 @@ Next, fill out the Offer Builder. Next, fill out the Offer Builder. For this exa
Offer Builder
-
After creating the Offer, Authorized Provider can save it as a local file or post it to a marketplace. @@ -715,7 +685,6 @@ For this example, we will change to the **VC Holder** wallet and load the Offer
Accept Offer
-
While the on-chain transaction to accept the Offer is pending, the 99 CR-CATs will be displayed in the VC Holder's `Pending Balance`. Note that the `Pending Balance for Approval` is `0` in this case: Note that the `Pending Balance for Approval` is `0` in this case: @@ -723,7 +692,6 @@ While the on-chain transaction to accept the Offer is pending, the 99 CR-CATs wi
Pending Offer Acceptance
-
After the transaction has been confirmed, the balance is updated. After the transaction has been confirmed, the balance is updated. When receiving CR-CATs via an Offer, there is no need to perform another transaction to approve of the incoming tokens. This is because the proof requirement is already baked into the Offer file. This is because the proof requirement is already baked into the Offer file. @@ -731,7 +699,6 @@ After the transaction has been confirmed, the balance is updated. After the tran
Completed Offer
-
At this point, the VC Holder wallet has full possession of the CR-CATs. @@ -870,7 +837,6 @@ Let's say the Authorized Provider obtains the XCH Wallet's address and sends 50
Send CR-CATs to address lacking proofs
-
Even though the recipient is not allowed to hold these CR-CATs, the transaction itself is valid. Even though the recipient is not allowed to hold these CR-CATs, the transaction itself is valid. However, just as in the examples at the beginning of this tutorial, the XCH Wallet will receive the CR-CATs in the `Pending Balance for Approval` section of the GUI. In this case, the required proof (in the red circle below) is not present. In this case, the required proof (in the red circle below) is not present. @@ -880,13 +846,11 @@ The XCH Wallet can still attempt to approve these CR-CATs:
Proof not present
-
Attempt to approve
-
However, this attempt will fail because the required proofs are missing: @@ -894,7 +858,6 @@ However, this attempt will fail because the required proofs are missing:
Required providers missing
-
The status of these CR-CATs is as follows: @@ -924,7 +887,6 @@ Let's say the owner of the XCH Wallet locates a CR-CAT Offer. Let's say the owne
Offer where required providers missing
-
Any attempts to accept this Offer without first receiving a VC with the required proofs will fail: @@ -932,7 +894,6 @@ Any attempts to accept this Offer without first receiving a VC with the required
Offer acceptance where required providers missing
-
Thus, when using Offers, the funds cannot accidentally be sent to an unauthorized recipient. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md index d17d335e02..cc6e3591ca 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-primitive-guide.md @@ -105,7 +105,6 @@ python -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` @@ -114,7 +113,6 @@ python3 -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/cats-offers-nfts.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/cats-offers-nfts.md index c6da7c5185..33b6d7ec0b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/cats-offers-nfts.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/cats-offers-nfts.md @@ -36,7 +36,6 @@ py -m venv venv ./venv/Scripts/activate py -m pip install --upgrade pip setuptools wheel pip install . -``` ``` @@ -49,9 +48,6 @@ python3 -m venv venv . ./venv/bin/activate python -m pip install --upgrade pip setuptools wheel pip install . -``` ./venv/bin/activate -python -m pip install --upgrade pip setuptools wheel -pip install . ``` @@ -348,7 +344,8 @@ Use chia wallet get_offers --id 41f5bfab75ff5f35489b0954597aa76c56ed7098aa9ad137 ``` -You'll notice there is a line for `Included Fees`, which is currently 0. As the blockchain becomes more saturated, a fee may need to be applied by either the maker or taker with an additional CLI flag. Let's continue by getting the offer's information. +You'll notice there is a line for `Included Fees`, which is currently 0. As the blockchain becomes more saturated, a fee may need to be applied by either the maker or taker with an additional CLI flag. +Let's continue by getting the offer's information. ```bash chia wallet get_offers --id 41f5bfab75ff5f35489b0954597aa76c56ed7098aa9ad137f0132b584541119f -f 1660000549 @@ -431,7 +428,8 @@ Once you have the image URL and the hash, we can create the NFT with a command l chia wallet nft mint -i -u -nh -m ``` -This will include the wallet ID, URL, data hash, and a fee. If this command is issued successfully, you will have created an NFT on Chia! +This will include the wallet ID, URL, data hash, and a fee. +If this command is issued successfully, you will have created an NFT on Chia! You can get the details of your new NFT with: @@ -467,32 +465,32 @@ Response: ``` NFT minted Successfully with spend bundle: { - 'aggregated_signature': '0x8673a394dca82d91cd1ddeff0b518cb02056fa24ce45b8cda4e7819258c9cc13a68ed71d4d25ef7254358af2f033d99b180b2b0255a8f113d699517e7019b825b09f68eb126da228f82b474f316bc8a657310a527ff54a4668971e9486c39c89', - 'coin_solutions': [{ - 'coin': { - 'amount': 1, - 'parent_coin_info': '0x75690e6a336be6223d3282d71085af366a1c94e9418c25ca9f5fba9d29e09a8d', - 'puzzle_hash': '0xd41dce69252d14db9a19eb0fcbd0e014d416245460b76a9fe4e7a8030e1bb4c6' - }, - 'puzzle_reveal': '0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa075690e6a336be6223d3282d71085af366a1c94e9418c25ca9f5fba9d29e09a8da0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc04468747470733a2f2f696d616765732e706578656c732e636f6d2f70686f746f732f31313035333037322f706578656c732d70686f746f2d31313035333037322e6a70656780ffff68a014836b86a48e1b2b5e857213af97534704475b4c155d34b2cb83ed4b7cba2bb0ffff826d7580ffff826c7580ffff82736e01ffff8273740180ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff17ffff04ff0bffff04ffff02ff2fff5f80ff80808080808080ffff04ffff01ffffff82ad4cff0233ffff3e04ff81f601ffffff0102ffff02ffff03ff05ffff01ff02ff2affff04ff02ffff04ff0dffff04ffff0bff32ffff0bff3cff3480ffff0bff32ffff0bff32ffff0bff3cff2280ff0980ffff0bff32ff0bffff0bff3cff8080808080ff8080808080ffff010b80ff0180ff04ffff04ff38ffff04ffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ffff02ff2effff04ff02ffff04ffff02ffff03ff81afffff0181afffff010b80ff0180ff80808080ffff04ffff0bff3cff4f80ffff04ffff0bff3cff0580ff8080808080808080ff378080ff82016f80ffffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff2fffff01ff80ff808080808080808080ff0bff32ffff0bff3cff2880ffff0bff32ffff0bff32ffff0bff3cff2280ff0580ffff0bff32ffff02ff2affff04ff02ffff04ff07ffff04ffff0bff3cff3c80ff8080808080ffff0bff3cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff5fffff01ff02ffff03ffff09ff82011fff3880ffff01ff02ffff03ffff09ffff18ff82059f80ff3c80ffff01ff02ffff03ffff20ff81bf80ffff01ff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff82019fffff04ff82017fff80808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff0180ffff01ff02ffff03ffff09ff82011fff2c80ffff01ff02ffff03ffff20ff82017f80ffff01ff04ffff04ff24ffff04ffff0eff10ffff02ff2effff04ff02ffff04ff82019fff8080808080ff808080ffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ffff02ff0bffff04ff17ffff04ff2fffff04ff82019fff8080808080ff8080808080808080808080ffff01ff088080ff0180ffff01ff02ffff03ffff09ff82011fff2480ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0122ffff0dff82029f8080ffff01ff02ffff03ffff09ffff0cff82029fff80ffff010280ff1080ffff01ff0101ff8080ff0180ff8080ff018080ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff8080808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff018080ff018080ff0180ffff01ff02ff3affff04ff02ffff04ff05ffff04ff0bffff04ff81bfffff04ffff02ffff03ff82017fffff0182017fffff01ff02ff0bffff04ff17ffff04ff2fffff01ff808080808080ff0180ff8080808080808080ff0180ff018080ffff04ffff01a0c5abea79afaa001b5427dfa0c8cf42ca6f38f5841b78f9b3c252733eb2de2726ffff04ffff0180ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff04ff82013fffff04ff80ffff04ffff02ffff03ffff22ff82013fffff20ffff09ff82013fff2f808080ffff01ff04ffff04ff10ffff04ffff0bffff02ff2effff04ff02ffff04ff09ffff04ff8205bfffff04ffff02ff3effff04ff02ffff04ffff04ff09ffff04ff82013fff1d8080ff80808080ff808080808080ff1580ff808080ffff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ffff01ff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ff0180ff80808080ffff01ff04ff2fffff01ff80ff80808080ff0180ffff04ffff01ffffff3f02ff04ff0101ffff822710ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff2cff1480ffff0bff2affff0bff2affff0bff2cff3c80ff0980ffff0bff2aff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ff17ffff01ff04ffff04ff10ffff04ffff0bff81a7ffff02ff3effff04ff02ffff04ffff04ff2fffff04ffff04ff05ffff04ffff05ffff14ffff12ff47ff0b80ff128080ffff04ffff04ff05ff8080ff80808080ff808080ff8080808080ff808080ffff02ff16ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fff8080808080808080ff8080ff0180ffff0bff2affff0bff2cff1880ffff0bff2affff0bff2affff0bff2cff3c80ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa075690e6a336be6223d3282d71085af366a1c94e9418c25ca9f5fba9d29e09a8da0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01a0c05f74b4f7e8b79dbb23118d7bcdebcadbaddac46824acebe455481c3ec850daffff04ffff0180ff0180808080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0815cec38feefbc2669d2eab272deb4badc17bc42a0f1cecbf1f5cf8c0219d9b7cdad195b9588291642db49da17b99b6eff018080ff018080808080ff018080808080ff01808080', - 'solution': '0xffffa02f1c4f4568c420033fb690c134ed3ed3d8d9fa3bdb75f1044d51789b59ea3a1dff0180ff01ffffffff80ffff01ffff81f6ff80ff80ff8080ffff33ffa0e68767ba2b431eb8efd9b8dd0db668d5c0c00c7a04e83f6bc6504c0f2626fdf6ff01ffffa0e68767ba2b431eb8efd9b8dd0db668d5c0c00c7a04e83f6bc6504c0f2626fdf6ffa0e68767ba2b431eb8efd9b8dd0db668d5c0c00c7a04e83f6bc6504c0f2626fdf6808080ff8080808080' - }, { - 'coin': { - 'amount': 9734999999, - 'parent_coin_info': '0x265cee97bfc72cc1c41692c9462d098009f5bcade81202cfbacf717a988b8667', - 'puzzle_hash': '0x7b0628c573b77df18bf858b6111be39e25e040f4fdb74c74702dfd94b1bd7fbb' - }, - 'puzzle_reveal': '0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aa1fdb303fb4e59c8082380e3462a0a4ff3f66ccfb5c40b33b6a13706206b1796f2a32c035a452a26d9926fccb0e3246ff018080', - 'solution': '0xff80ffff01ffff33ffa0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ff0180ffff33ffa0e520db6f3cab1c1a26f84f6bb19f44c103a3609a2b552ed1e2647dbf600fd160ff85023474bb7e80ffff34ff840fcb944080ffff3cffa0a8520fb03d767496573596438ba3e9414cc845b1d2ab26c159ab64be397dd7ba80ffff3dffa05751070a5bfeabb3f71640bacfa81ea2275c36a25a60bb4381ef598cb56bca578080ff8080' - }, { - 'coin': { - 'amount': 1, - 'parent_coin_info': '0x2f1c4f4568c420033fb690c134ed3ed3d8d9fa3bdb75f1044d51789b59ea3a1d', - 'puzzle_hash': '0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9' - }, - 'puzzle_reveal': '0xff02ffff01ff04ffff04ff04ffff04ff05ffff04ff0bff80808080ffff04ffff04ff0affff04ffff02ff0effff04ff02ffff04ffff04ff05ffff04ff0bffff04ff17ff80808080ff80808080ff808080ff808080ffff04ffff01ff33ff3cff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff0effff04ff02ffff04ff09ff80808080ffff02ff0effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080', - 'solution': '0xffa0d41dce69252d14db9a19eb0fcbd0e014d416245460b76a9fe4e7a8030e1bb4c6ff01ff8080' - }] + 'aggregated_signature': '0x8673a394dca82d91cd1ddeff0b518cb02056fa24ce45b8cda4e7819258c9cc13a68ed71d4d25ef7254358af2f033d99b180b2b0255a8f113d699517e7019b825b09f68eb126da228f82b474f316bc8a657310a527ff54a4668971e9486c39c89', + 'coin_solutions': [{ + 'coin': { + 'amount': 1, + 'parent_coin_info': '0x75690e6a336be6223d3282d71085af366a1c94e9418c25ca9f5fba9d29e09a8d', + 'puzzle_hash': '0xd41dce69252d14db9a19eb0fcbd0e014d416245460b76a9fe4e7a8030e1bb4c6' + }, + 'puzzle_reveal': '0xff02ffff01ff02ffff01ff02ffff03ffff18ff2fff3480ffff01ff04ffff04ff20ffff04ff2fff808080ffff04ffff02ff3effff04ff02ffff04ff05ffff04ffff02ff2affff04ff02ffff04ff27ffff04ffff02ffff03ff77ffff01ff02ff36ffff04ff02ffff04ff09ffff04ff57ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ffff011d80ff0180ffff04ffff02ffff03ff77ffff0181b7ffff015780ff0180ff808080808080ffff04ff77ff808080808080ffff02ff3affff04ff02ffff04ff05ffff04ffff02ff0bff5f80ffff01ff8080808080808080ffff01ff088080ff0180ffff04ffff01ffffffff4947ff0233ffff0401ff0102ffffff20ff02ffff03ff05ffff01ff02ff32ffff04ff02ffff04ff0dffff04ffff0bff3cffff0bff34ff2480ffff0bff3cffff0bff3cffff0bff34ff2c80ff0980ffff0bff3cff0bffff0bff34ff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ffff22ffff09ffff0dff0580ff2280ffff09ffff0dff0b80ff2280ffff15ff17ffff0181ff8080ffff01ff0bff05ff0bff1780ffff01ff088080ff0180ff02ffff03ff0bffff01ff02ffff03ffff02ff26ffff04ff02ffff04ff13ff80808080ffff01ff02ffff03ffff20ff1780ffff01ff02ffff03ffff09ff81b3ffff01818f80ffff01ff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff808080808080ffff01ff04ffff04ff23ffff04ffff02ff36ffff04ff02ffff04ff09ffff04ff53ffff04ffff02ff2effff04ff02ffff04ff05ff80808080ff808080808080ff738080ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff34ff8080808080808080ff0180ffff01ff088080ff0180ffff01ff04ff13ffff02ff3affff04ff02ffff04ff05ffff04ff1bffff04ff17ff8080808080808080ff0180ffff01ff02ffff03ff17ff80ffff01ff088080ff018080ff0180ffffff02ffff03ffff09ff09ff3880ffff01ff02ffff03ffff18ff2dffff010180ffff01ff0101ff8080ff0180ff8080ff0180ff0bff3cffff0bff34ff2880ffff0bff3cffff0bff3cffff0bff34ff2c80ff0580ffff0bff3cffff02ff32ffff04ff02ffff04ff07ffff04ffff0bff34ff3480ff8080808080ffff0bff34ff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ffff21ff17ffff09ff0bff158080ffff01ff04ff30ffff04ff0bff808080ffff01ff088080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa075690e6a336be6223d3282d71085af366a1c94e9418c25ca9f5fba9d29e09a8da0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc04468747470733a2f2f696d616765732e706578656c732e636f6d2f70686f746f732f31313035333037322f706578656c732d70686f746f2d31313035333037322e6a70656780ffff68a014836b86a48e1b2b5e857213af97534704475b4c155d34b2cb83ed4b7cba2bb0ffff826d7580ffff826c7580ffff82736e01ffff8273740180ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ff26ffff04ff02ffff04ff05ffff04ff17ffff04ff0bffff04ffff02ff2fff5f80ff80808080808080ffff04ffff01ffffff82ad4cff0233ffff3e04ff81f601ffffff0102ffff02ffff03ff05ffff01ff02ff2affff04ff02ffff04ff0dffff04ffff0bff32ffff0bff3cff3480ffff0bff32ffff0bff32ffff0bff3cff2280ff0980ffff0bff32ff0bffff0bff3cff8080808080ff8080808080ffff010b80ff0180ff04ffff04ff38ffff04ffff02ff36ffff04ff02ffff04ff05ffff04ff27ffff04ffff02ff2effff04ff02ffff04ffff02ffff03ff81afffff0181afffff010b80ff0180ff80808080ffff04ffff0bff3cff4f80ffff04ffff0bff3cff0580ff8080808080808080ff378080ff82016f80ffffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff2fffff01ff80ff808080808080808080ff0bff32ffff0bff3cff2880ffff0bff32ffff0bff32ffff0bff3cff2280ff0580ffff0bff32ffff02ff2affff04ff02ffff04ff07ffff04ffff0bff3cff3c80ff8080808080ffff0bff3cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff5fffff01ff02ffff03ffff09ff82011fff3880ffff01ff02ffff03ffff09ffff18ff82059f80ff3c80ffff01ff02ffff03ffff20ff81bf80ffff01ff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff82019fffff04ff82017fff80808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff0180ffff01ff02ffff03ffff09ff82011fff2c80ffff01ff02ffff03ffff20ff82017f80ffff01ff04ffff04ff24ffff04ffff0eff10ffff02ff2effff04ff02ffff04ff82019fff8080808080ff808080ffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ffff02ff0bffff04ff17ffff04ff2fffff04ff82019fff8080808080ff8080808080808080808080ffff01ff088080ff0180ffff01ff02ffff03ffff09ff82011fff2480ffff01ff02ffff03ffff20ffff02ffff03ffff09ffff0122ffff0dff82029f8080ffff01ff02ffff03ffff09ffff0cff82029fff80ffff010280ff1080ffff01ff0101ff8080ff0180ff8080ff018080ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff8080808080808080808080ffff01ff088080ff0180ffff01ff04ff819fffff02ff3effff04ff02ffff04ff05ffff04ff0bffff04ff17ffff04ff2fffff04ff81dfffff04ff81bfffff04ff82017fff808080808080808080808080ff018080ff018080ff0180ffff01ff02ff3affff04ff02ffff04ff05ffff04ff0bffff04ff81bfffff04ffff02ffff03ff82017fffff0182017fffff01ff02ff0bffff04ff17ffff04ff2fffff01ff808080808080ff0180ff8080808080808080ff0180ff018080ffff04ffff01a0c5abea79afaa001b5427dfa0c8cf42ca6f38f5841b78f9b3c252733eb2de2726ffff04ffff0180ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff81bfffff01ff04ff82013fffff04ff80ffff04ffff02ffff03ffff22ff82013fffff20ffff09ff82013fff2f808080ffff01ff04ffff04ff10ffff04ffff0bffff02ff2effff04ff02ffff04ff09ffff04ff8205bfffff04ffff02ff3effff04ff02ffff04ffff04ff09ffff04ff82013fff1d8080ff80808080ff808080808080ff1580ff808080ffff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ffff01ff02ff16ffff04ff02ffff04ff0bffff04ff17ffff04ff8202bfffff04ff15ff8080808080808080ff0180ff80808080ffff01ff04ff2fffff01ff80ff80808080ff0180ffff04ffff01ffffff3f02ff04ff0101ffff822710ff02ff02ffff03ff05ffff01ff02ff3affff04ff02ffff04ff0dffff04ffff0bff2affff0bff2cff1480ffff0bff2affff0bff2affff0bff2cff3c80ff0980ffff0bff2aff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff02ffff03ff17ffff01ff04ffff04ff10ffff04ffff0bff81a7ffff02ff3effff04ff02ffff04ffff04ff2fffff04ffff04ff05ffff04ffff05ffff14ffff12ff47ff0b80ff128080ffff04ffff04ff05ff8080ff80808080ff808080ff8080808080ff808080ffff02ff16ffff04ff02ffff04ff05ffff04ff0bffff04ff37ffff04ff2fff8080808080808080ff8080ff0180ffff0bff2affff0bff2cff1880ffff0bff2affff0bff2affff0bff2cff3c80ff0580ffff0bff2affff02ff3affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff3effff04ff02ffff04ff09ff80808080ffff02ff3effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01ffa07faa3253bfddd1e0decb0906b2dc6247bbc4cf608f58345d173adb63e8b47c9fffa075690e6a336be6223d3282d71085af366a1c94e9418c25ca9f5fba9d29e09a8da0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ffff04ffff01a0c05f74b4f7e8b79dbb23118d7bcdebcadbaddac46824acebe455481c3ec850daffff04ffff0180ff0180808080ffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0815cec38feefbc2669d2eab272deb4badc17bc42a0f1cecbf1f5cf8c0219d9b7cdad195b9588291642db49da17b99b6eff018080ff018080808080ff018080808080ff01808080', + 'solution': '0xffffa02f1c4f4568c420033fb690c134ed3ed3d8d9fa3bdb75f1044d51789b59ea3a1dff0180ff01ffffffff80ffff01ffff81f6ff80ff80ff8080ffff33ffa0e68767ba2b431eb8efd9b8dd0db668d5c0c00c7a04e83f6bc6504c0f2626fdf6ff01ffffa0e68767ba2b431eb8efd9b8dd0db668d5c0c00c7a04e83f6bc6504c0f2626fdf6ffa0e68767ba2b431eb8efd9b8dd0db668d5c0c00c7a04e83f6bc6504c0f2626fdf6808080ff8080808080' + }, { + 'coin': { + 'amount': 9734999999, + 'parent_coin_info': '0x265cee97bfc72cc1c41692c9462d098009f5bcade81202cfbacf717a988b8667', + 'puzzle_hash': '0x7b0628c573b77df18bf858b6111be39e25e040f4fdb74c74702dfd94b1bd7fbb' + }, + 'puzzle_reveal': '0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aa1fdb303fb4e59c8082380e3462a0a4ff3f66ccfb5c40b33b6a13706206b1796f2a32c035a452a26d9926fccb0e3246ff018080', + 'solution': '0xff80ffff01ffff33ffa0eff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9ff0180ffff33ffa0e520db6f3cab1c1a26f84f6bb19f44c103a3609a2b552ed1e2647dbf600fd160ff85023474bb7e80ffff34ff840fcb944080ffff3cffa0a8520fb03d767496573596438ba3e9414cc845b1d2ab26c159ab64be397dd7ba80ffff3dffa05751070a5bfeabb3f71640bacfa81ea2275c36a25a60bb4381ef598cb56bca578080ff8080' + }, { + 'coin': { + 'amount': 1, + 'parent_coin_info': '0x2f1c4f4568c420033fb690c134ed3ed3d8d9fa3bdb75f1044d51789b59ea3a1d', + 'puzzle_hash': '0xeff07522495060c066f66f32acc2a77e3a3e737aca8baea4d1a64ea4cdc13da9' + }, + 'puzzle_reveal': '0xff02ffff01ff04ffff04ff04ffff04ff05ffff04ff0bff80808080ffff04ffff04ff0affff04ffff02ff0effff04ff02ffff04ffff04ff05ffff04ff0bffff04ff17ff80808080ff80808080ff808080ff808080ffff04ffff01ff33ff3cff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff0effff04ff02ffff04ff09ff80808080ffff02ff0effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080', + 'solution': '0xffa0d41dce69252d14db9a19eb0fcbd0e014d416245460b76a9fe4e7a8030e1bb4c6ff01ff8080' + }] } ``` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md index 8dfbc98c62..43bc2318a1 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md @@ -80,7 +80,6 @@ python -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` @@ -89,7 +88,6 @@ python3 -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` @@ -125,7 +123,7 @@ If you get a usage statement, then `cic` (Chia Internal Custody) has been instal --- -## Command Notes +### Command Notes :::info A few notes about the commands in this guide @@ -139,9 +137,12 @@ Most of the commands from this tutorial will _not_ alter the blockchain. This in :::warning warning for windows users -Windows uses different line endings than Linux and MacOS. If you only plan to use Windows for both generating and signing spend bundles, this won't be a problem. +Windows uses different line endings than Linux and MacOS. +If you only plan to use Windows for both generating and signing spend bundles, this won't be a problem. -However, if you plan to generate your spend bundles on Windows and sign them using a Linux HSM, then you will need to modify the line endings before signing. The easiest way to accomplish this is with `dos2unix`. This is not included with Windows, so you will need to download it from [SourceForge](https://sourceforge.net/projects/dos2unix/). +However, if you plan to generate your spend bundles on Windows and sign them using a Linux HSM, then you will need to modify the line endings before signing. +The easiest way to accomplish this is with `dos2unix`. +This is not included with Windows, so you will need to download it from [SourceForge](https://sourceforge.net/projects/dos2unix/). The command to convert your spend bundles is then: @@ -315,9 +316,12 @@ As a result of running this command, `Configuration (awaiting launch).txt` will ::: -In this step, you will run `cic launch_singleton`, which will create the singleton on the blockchain. In order to run this command, you will need to have at least 1 mojo in your wallet to create the singleton. +In this step, you will run `cic launch_singleton`, which will create the singleton on the blockchain. +In order to run this command, you will need to have at least 1 mojo in your wallet to create the singleton. -The `launch_singleton` command also includes a recommended `--fee` flag to specify a blockchain fee in mojos. This fee is completely separate from the actual financing of the singleton, which will occur in a later step. It is also possible to launch the singleton using one wallet and fund it with another -- think of the singleton as a brand new wallet. +The `launch_singleton` command also includes a recommended `--fee` flag to specify a blockchain fee in mojos. +This fee is completely separate from the actual financing of the singleton, which will occur in a later step. +It is also possible to launch the singleton using one wallet and fund it with another -- think of the singleton as a brand new wallet. Aside from the fees, the `launch_singleton` command includes an optional `--configuration` flag to specify the name and location of the configuration file. By default, the command will look in `./Configuration (awaiting launch).txt`. @@ -371,7 +375,8 @@ Congratulations, you have successfully launched the singleton! (You will need to At this point, the singleton should exist on the blockchain. However, it has not yet been funded. For now, let's view it. -Currently your local custody database does not know about the singleton. Therefore, in order to view the singleton, you must first synchronize the localhost with the blockchain by running the `sync` command. +Currently your local custody database does not know about the singleton. +Therefore, in order to view the singleton, you must first synchronize the localhost with the blockchain by running the `sync` command. The first time you run the `sync` command, you need to specify the configuration file, which will then be copied into your config database. @@ -404,7 +409,9 @@ Outstanding events: REKEYS: ``` -To view the configuration, run `cic show` and add the `-c` flag. To view the derivation info, run `cic show` and add the `-d` flag. You can also add both flags. +To view the configuration, run `cic show` and add the `-c` flag. +To view the derivation info, run `cic show` and add the `-d` flag. +You can also add both flags. For example: @@ -622,7 +629,8 @@ This test will run through the complete sequence of withdrawing money from the s This command generates an unsigned spend bundle which requires specific keys. Signers can take this spend bundle to an HSM for signing. -To begin the payment process, use the `cic payment` command. For this example, we'll use the following arguments (see the [CLI reference](/custody-tool#payment "payment command") for all options): +To begin the payment process, use the `cic payment` command. +For this example, we'll use the following arguments (see the [CLI reference](/custody-tool#payment "payment command") for all options): - `-f` : The name of the file in which to save the unsigned spend bundle - `-pks`: The public keys that will be used to sign the withdrawal. Exactly `m` keys must be included. The only keys allowed to sign are those that were originally used in the `derive_root` command @@ -745,7 +753,9 @@ Once you have the signed spend bundle on a synced node with some XCH/TXCH for a cic push_tx -b ./withdrawal.signed -m 10000000 ``` -The withdrawal has now been added to the blockchain. However, the money has not yet reached its final destination. Instead, it will now sit in a "drop coin" (aka escrow) and cannot be withdrawn for at least (`-pc`) seconds, which is built into the singleton and cannot be changed. For this example, we used 1200 seconds for this value. +The withdrawal has now been added to the blockchain. However, the money has not yet reached its final destination. +Instead, it will now sit in a "drop coin" (aka escrow) and cannot be withdrawn for at least (`-pc`) seconds, which is built into the singleton and cannot be changed. +For this example, we used 1200 seconds for this value. #### View the payment's status @@ -786,7 +796,9 @@ As the output of this command shows, there is a new payment outstanding (`PAYMEN - If (`-pc`) seconds have not elapsed since the drop coin's creation, the output will display `(Ready at: )` - If (`-pc`) seconds have elapsed, then the output will say `(Ready)` -In either case, claw backs are allowed until the payment has been completed. (Even if the withdrawal is in "Ready" state, it can still be clawed back. However, because _anyone_ can complete the withdrawal, claw backs should no longer be assumed to be available once the "Ready" state has been reached.) +In either case, claw backs are allowed until the payment has been completed. +(Even if the withdrawal is in "Ready" state, it can still be clawed back. However, because _anyone_ can +complete the withdrawal, claw backs should no longer be assumed to be available once the "Ready" state has been reached.) Note that even when the state is "Ready", the next transaction block will still need to be created before the withdrawal is _actually_ ready. @@ -959,7 +971,8 @@ Outstanding events: REKEYS: ``` -Instead of completing the payment, we'll claw it back. If you want to test this feature, be sure to make the value of `-pc` sufficiently large to give yourself plenty of time to perform the clawback. In this example we still have 17 minutes remaining (`Ready at` minus `Current time` from the above output). +Instead of completing the payment, we'll claw it back. If you want to test this feature, be sure to make the value of `-pc` sufficiently large to give yourself plenty of time to perform the clawback. +In this example we still have 17 minutes remaining (`Ready at` minus `Current time` from the above output). #### Create an unsigned spend bundle for the clawback @@ -1043,7 +1056,8 @@ echo 549614102252741379514039214279174962654364157854486736945228183041555384205 This command should have no output. The signatures are now stored in text files. -Finally, merge the claw back signatures into a signed spend bundle. Note that an arbitrary number of signatures can be passed into this command. We'll use two signatures for this example. +Finally, merge the claw back signatures into a signed spend bundle. +Note that an arbitrary number of signatures can be passed into this command. We'll use two signatures for this example. ```bash hsmmerge ./clawback.unsigned ./clawback_1.sig ./clawback_2.sig > clawback.signed @@ -1243,7 +1257,9 @@ Custody rules successfully added to configuration ::: -Next, run `start_rekey`, which will create an unsigned spend bundle for the rekey. Note that in this command, `-pks` refers to the original keys that must sign to allow the rekey to happen. The configuration file from the `-new` flag contains all of the new info that will be used after the rekey has completed. +Next, run `start_rekey`, which will create an unsigned spend bundle for the rekey. Note that in this command, +`-pks` refers to the original keys that must sign to allow the rekey to happen. +The configuration file from the `-new` flag contains all of the new info that will be used after the rekey has completed. ```bash cic start_rekey -f rekey.unsigned -pks "1.pk,2.pk" -new './Configuration (after rekey).txt' @@ -1302,7 +1318,9 @@ echo 555391688726247518407714092604079246104554134754321333331702549926309406250 echo 5561137392380018602752549597282386367838345256392677171809614780347764174154608487537742644428466353746831639451621586320322685820178179047514852085991565214608652175820480007073564769669494661900487484133333312104972188050976529086895435776 > rekey_2.sig ``` -Finally, merge the rekey signatures into a signed spend bundle. Note that an arbitrary number of signatures can be passed into this command. For this example, we need to use the two signatures we just calculated: +Finally, merge the rekey signatures into a signed spend bundle. +Note that an arbitrary number of signatures can be passed into this command. +For this example, we need to use the two signatures we just calculated: ```bash hsmmerge ./rekey.unsigned ./rekey_1.sig ./rekey_2.sig > rekey.signed @@ -1373,9 +1391,12 @@ As the output of this command shows, there is a new rekey outstanding (`REKEY fr - If (`-rc`) seconds have not elapsed since the drop coin's creation, the output will display `(Ready at: )` - If (`-rc`) seconds have elapsed, then the output will say `(Ready)` -In either case, cancellation/clawback is allowed until the rekey is completed. (Even if the rekey is in "Ready" state, it can still be clawed back. However, because _anyone_ can complete the rekey, claw backs should no longer be assumed to be available once it reaches the "Ready" state.) +In either case, cancellation/clawback is allowed until the rekey is completed. +(Even if the rekey is in "Ready" state, it can still be clawed back. However, because _anyone_ can +complete the rekey, claw backs should no longer be assumed to be available once it reaches the "Ready" state.) -Note that even when the state is "Ready", the next transaction block will still need to be created before the rekey is _actually_ ready. Transaction blocks happen every 52 seconds on average. +Note that even when the state is "Ready", the next transaction block will still need to be created before the rekey is _actually_ ready. +Transaction blocks happen every 52 seconds on average. #### Create a signed spend bundle for the completion diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md index cb5d4e9b59..18bdf90209 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/prefarm-audit.md @@ -3,11 +3,11 @@ slug: /custody/prefarm-audit-tutorial title: Prefarm Audit Tutorial --- -Chia Network Inc's prefarm is secured by a complex set of custodial rules. This document describes how to use the custody tool to audit the prefarm configuration. A moderate level of technical proficiency is probably needed to understand the details. For a high-level overview of the prefarm custody wallets, see our [blog post](https://www.chia.net/2022/10/29/a-new-home-for-the-prefarm/). This document describes how to use the custody tool to audit the prefarm configuration. A moderate level of technical proficiency is probably needed to understand the details. For a high-level overview of the prefarm custody wallets, see our [blog post](https://www.chia.net/2022/10/29/a-new-home-for-the-prefarm/). +Chia Network Inc's prefarm is secured by a complex set of custodial rules. This document describes how to use the custody tool to audit the prefarm configuration. A moderate level of technical proficiency is probably needed to understand the details. For a high-level overview of the prefarm custody wallets, see our [blog post](https://www.chia.net/2022/10/29/a-new-home-for-the-prefarm/). Other relevant documents: -- [Flow chart](/img/chia-custody-tool.png) to visualize how the custody tool works +- [Flow chart](https://docs.chia.net/img/chia-custody-tool.png) to visualize how the custody tool works - [User guide](/guides/custody-tool-user-guide) to help you get up and running - [CLI reference](/custody-tool) for all custody commands used in this tutorial - [Prefarm Alert Tool](https://github.com/Chia-Network/prefarm-alert) to access the public prefarm config files @@ -76,7 +76,9 @@ xch1jj0gm4ahhlu3ke0r0fx955v8axr6za7rzz6hc0y26lewa7zw6fws5nwvv6 :::info -NOTE: A high level of technical proficiency is needed to understand the details of this manual process for what the cic tool does above. This process is a high-level guide and does not display expected results for each step. NOTE: A high level of technical proficiency is needed to understand the details of this manual process for what the cic tool does above. This process is a high-level guide and does not display expected results for each step. The [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools#install) are needed for this audit. +NOTE: A high level of technical proficiency is needed to understand the details of this manual process for what the cic tool does above. +This process is a high-level guide and does not display expected results for each step. +The [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools#install) are needed for this audit. ::: @@ -91,7 +93,7 @@ NOTE: A high level of technical proficiency is needed to understand the details 4. `BASE_REKEY_TIMELOCK` = integer of the rekey timelock. 5. `SLOW_REKEY_PENALTY` = integer of the slow rekey penalty. 3. Curry the necessary parameters into singleton_top_layer_v1_1.clsp `(SINGLETON_STRUCT INNER_PUZZLE)`: - 1. `SINGLETON_STRUCT` = a tree with the following elements in order `(MOD_HASH . (LAUNCHER_ID . LAUNCHER_PUZZLE_HASH))`: (LAUNCHER_ID . LAUNCHER_PUZZLE_HASH)): + 1. `SINGLETON_STRUCT` = a tree with the following elements in order `(MOD_HASH . (LAUNCHER_ID . LAUNCHER_PUZZLE_HASH))`: 1. `MOD_HASH` = singleton_top_layer puzzle sha256 tree hash without its curried arguments. 2. `LAUNCHER_ID` = the ID of the singleton we are committed to paying. 3. `LAUNCHER_PUZZLE_HASH` = the puzzle hash of the launcher. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md index a31ce82828..0286378474 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-bulk-mint.md @@ -105,7 +105,6 @@ python -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` @@ -114,7 +113,6 @@ python3 -m venv venv ```bash python3 -m venv venv . ./venv/bin/activate -``` ./venv/bin/activate ``` @@ -141,11 +139,14 @@ chia configure --testnet true ``` :::note -If you previously had been running Chia on mainnet, then your peers table will be populated with mainnet peers. When you switch to running on the testnet, the peers listed in this table will time out. Eventually the table will be repopulated with testnet peers, but this can take a long time. In order to expedite this process, We recommend that you delete your peers tables: +If you previously had been running Chia on mainnet, then your peers table will be populated with mainnet peers. +When you switch to running on the testnet, the peers listed in this table will time out. +Eventually the table will be repopulated with testnet peers, but this can take a long time. +In order to expedite this process, We recommend that you delete your peers tables: - `~/.chia/mainnet/db/peers.dat` - `~/.chia/mainnet/wallet/db/wallet_peers.dat` -::: + ::: 2. We recommend that you use `INFO` level logging instead of the default `WARNING` level. To do this, run: @@ -184,7 +185,7 @@ Showing all public and private keys Fingerprint: 3049838316 (...) - Mnemonic seed (24 secret words): + Mnemonic seed (24 secret words): youth stomach social aware clay pottery benefit asthma mail cry rubber panda wife around provide atom cute sand staff exotic pink east gloom minute ``` @@ -198,7 +199,7 @@ If you ever need to display your address, run `chia keys show`. This command wil 6. In order to continue, you will need to have some TXCH in your wallet. If your total balance is 0, you can obtain 1 TXCH from our faucet. Copy the value of "First wallet address:" from the output of the `chia keys show` command. It will be a long string beginning with "txch". -Open our [testnet faucet page](https://testnet10-faucet.chia.net "Chia's testnet10 faucet link"). Paste your address and click "Submit". Paste your address and click "Submit". +Open our [testnet faucet page](https://testnet11-faucet.chia.net "Chia's testnet11 faucet link"). Paste your address and click "Submit". You will receive this message: `Accepted. Your request is in the queue and will be processed in the order it was received.` At some point you will receive 1 TXCH. Depending on how busy the faucet and the testnet are, this could take several minutes. However, you don't need to wait for your coins to arrive before continuing. @@ -208,12 +209,12 @@ You will receive this message: `Accepted. Your request is in the queue and will mkdir ~/.chia/mainnet/db ``` -8. If you downloaded a copy of the testnet database, you will need to wait for the download to complete before continuing. After the download has completed, use an archive manager such as [7-Zip](https://www.7-zip.org/ "7-Zip's website") to extract the file. If you downloaded a copy of the testnet database, you will need to wait for the download to complete before continuing. After the download has completed, use an archive manager such as [7-Zip](https://www.7-zip.org/ "7-Zip's website") to extract the file. You should now have a file in your Downloads folder called `blockchain_v2_testnet10.sqlite`. +8. If you downloaded a copy of the testnet database, you will need to wait for the download to complete before continuing. After the download has completed, use an archive manager such as [7-Zip](https://www.7-zip.org/ "7-Zip's website") to extract the file. You should now have a file in your Downloads folder called `blockchain_v2_testnet11.sqlite`. Move the database to the folder you just created: ```bash -mv ~/Downloads/blockchain_v2_testnet10.sqlite ~/.chia/mainnet/db +mv ~/Downloads/blockchain_v2_testnet11.sqlite ~/.chia/mainnet/db ``` 9. Start the full node, which will begin syncing to the database file: @@ -234,9 +235,9 @@ chia show -s Eventually, it will say `Full Node Synced`: ```text -Network: testnet10 Port: 58444 RPC Port: 8555 +Network: testnet11 Port: 58444 RPC Port: 8555 Node ID: 82a73b06b3a5f9493a3ac4e3d903026b39c85b748158ba41c623d531947f2a2a -Genesis Challenge: ae83525ba8d1dd3f09b277de18ca3e43fc0af20d20c4b3e92ef2a48bd291ccb2 +Genesis Challenge: 37a90eb5185a9c4439a91ddc98bbadce7b4feba060d50116a067de66bf236615 Current Blockchain Status: Full Node Synced ``` @@ -505,7 +506,7 @@ chianft submit-spend-bundles -m 10 -o 100 output.pkl Each time a spend bundle is submitted, some status info will appear. For example: ```bash -SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s +SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s ``` Expect the total time for each spend bundle to be around 1-2 minutes. A project with `10 000` NFTs could take anywhere from 7-14 hours to complete. @@ -599,7 +600,7 @@ This can be safely ignored. 4. Submit the spend bundles created in the output file (output.pkl in this example). This command has two flags: - `-m`: an optional transaction fee, in mojos. This is a fee to be used for inclusion in the blockchain, completely separate from the royalty percentage. This fee will be applied once per spend bundle of 25 NFTs. The bulk mint tool will not verify that you have enough money to cover this fee beforehand - - `-o`: _Not set._ In this example, we don't provide this option as we will be air-dropping them to their targeted address in the `metadata.csv`. We declared these spend bundles to include a targeted address in the previous command. We would not be able to create offers for NFTs where we are offering the NFT if we are not the owner. (The air-drop address is the NFT owner.) We declared these spend bundles to include a targeted address in the previous command. We would not be able to create offers for NFTs where we are offering the NFT if we are not the owner. (The air-drop address is the NFT owner.) + - `-o`: _Not set._ In this example, we don't provide this option as we will be air-dropping them to their targeted address in the `metadata.csv`. We declared these spend bundles to include a targeted address in the previous command. We would not be able to create offers for NFTs where we are offering the NFT if we are not the owner. (The air-drop address is the NFT owner.) ```bash chianft submit-spend-bundles -m 10 output.pkl @@ -608,7 +609,7 @@ chianft submit-spend-bundles -m 10 output.pkl Each time a spend bundle is submitted, some status info will appear. For example: ```bash -SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s +SUBMITTED: 1/4 TX: 104.70s FEE: 0.04s OFFER: 6.02s TOTAL: 120.77s ``` Expect the total time for each spend bundle to be around 1-2 minutes. A project with `10 000` NFTs could take anywhere from 7-14 hours to complete. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md index 1b0166c782..e82e74dcbf 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md @@ -15,7 +15,7 @@ To create plots, you must have: This page will give a basic overview of how to obtain these values. This page will give a basic overview of how to obtain these values. For a detailed description, see the [Beginner's Guide to Farming](/farming-guide). -If you already have a wallet with a plot NFT, feel free to skip to the section for [CLI Plotting](#cli-plotting) or [GUI Plotting](#gui-plotting). +If you already have a wallet with a plot NFT, feel free to skip to the section for [CLI Plotting](#cli-plotting) or [GUI Plotting](#图形用户界面gui生成地块). ## Public Keys diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md index 38294c098c..ba8a59b39a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md @@ -974,18 +974,21 @@ Notes: Create a new wallet with some basic DAO rules; also mint CATs and include transaction fees: ```bash -Note: Because backup_dids is required, you must already have access to a DID in order to run this RPC for a did_wallet. If you do not already have a DID, then run the CLI command to create a DID wallet instead. If you do not already have a DID, then run the CLI command to create a DID wallet instead. +chia rpc wallet create_new_wallet '{"wallet_type": "dao_wallet", "mode": "new", "name": "My Dao Wallet", "dao_rules": {"attendance_required": 3000, "oracle_spend_delay": 2, "pass_percentage": 5000, "proposal_minimum_amount": 1000001, "proposal_timelock": 3, "self_destruct_length": 1, "soft_close_length": 2}, "amount_of_cats": 1000, "filter-amount": 1, "fee": 500000000, "fee_for_cat": 100000000}' ``` - is required, you must already have access to a DID in order to run this RPC for a did_wallet. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. - As a result, a new treasury will be created, along with a CAT wallet containing 1000 CATs, and a DAO CAT wallet: ```bash -For this example, we'll use the wallet with ID 7. This wallet is type 6 (CAT): +{ + "cat_wallet_id": 4, + "dao_cat_wallet_id": 5, + "success": true, + "treasury_id": "0x89fdd510ce617c0b78d7f997d6fe52737a8c57100cca73c9dc4957eaf7fe55dc", + "type": 14, + "wallet_id": 3 +} ``` -. This wallet is type 6 (CAT): -
@@ -995,18 +998,21 @@ For this example, we'll use the wallet with ID 7. This wallet is ty To join a DAO, set `mode` to `existing`: ```bash -This coin is "type": 7, so it is being sent from this wallet. This RPC can be used to claw back this coin as long as it has yet to be spent by the recipient wallet: +chia rpc wallet create_new_wallet '{"wallet_type": "dao_wallet", "mode": "existing", "name": "My Dao Wallet", "filter-amount": 1, "treasury_id": "0x89fdd510ce617c0b78d7f997d6fe52737a8c57100cca73c9dc4957eaf7fe55dc"}' ``` -, so it is being sent from this wallet. This RPC can be used to claw back this coin as long as it has yet to be spent by the recipient wallet: - Your wallet will join the treasury and automatically create the required DAO, CAT, and DAO_CAT wallets without any balance: ```bash -The type of wallet to create. The type of wallet to create. Must be one of cat_wallet, did_wallet, nft_wallet, or pool_wallet +{ + "cat_wallet_id": 3, + "dao_cat_wallet_id": 4, + "success": true, + "treasury_id": "0x89fdd510ce617c0b78d7f997d6fe52737a8c57100cca73c9dc4957eaf7fe55dc", + "type": 14, + "wallet_id": 2 +} ``` -, did_wallet, nft_wallet, or pool_wallet -
@@ -1696,7 +1702,9 @@ The transaction history is not deterministic due to heuristics we use to counter - Transactions of one Offer do not share the same id`s. To match them up, it is best to keep the offer files - The transaction time is a rough estimate. When an offer is accepted, the individual transactions of one offer can/will have slightly differing transaction times - For your offers which were accepted by a 3rd Party , the incoming coins are beeing marked as incoming transaction, not as incoming trade -- When cancelling offers, the cancellation Transactions are beeing shown as transaction, not as trade For accurate records, you should keep a local record of transactions (TXs) and the Offer files made. +- When cancelling offers, the cancellation Transactions are beeing shown as transaction, not as trade +For accurate records, you should keep a local record of transactions (TXs) and the Offer files made. +
Example @@ -1775,7 +1783,8 @@ Request Parameters:
Notes about transactions -By default, the function lists the oldest transactions first. This is recommended for building a transaction history due to pagination. If reverse is set to true, it lists the newest transactions first. This is most useful for fetching recent transactions. +By default, the function lists the oldest transactions first. This is recommended for building a transaction history due to pagination. +If reverse is set to true, it lists the newest transactions first. This is most useful for fetching recent transactions. The transaction history is not deterministic due to heuristics we use to counter privacy features of the blockchain. This means, a couple of details cannot be fetched fully: @@ -1785,7 +1794,9 @@ The transaction history is not deterministic due to heuristics we use to counter - Transactions of one Offer do not share the same id`s. To match them up, it is best to keep the offer files - The transaction time is a rough estimate. When an offer is accepted, the individual transactions of one offer can/will have slightly differing transaction times - For your offers which were accepted by a 3rd Party , the incoming coins are beeing marked as incoming transaction, not as incoming trade -- When cancelling offers, the cancellation Transactions are beeing shown as transaction, not as trade For accurate records, you should keep a local record of transactions (TXs) and the Offer files made.
+- When cancelling offers, the cancellation Transactions are beeing shown as transaction, not as trade +For accurate records, you should keep a local record of transactions (TXs) and the Offer files made. +
Example 1: List a single XCH transaction @@ -2414,8 +2425,6 @@ Result: ```bash { - "nft_info": { - "chain_info": "((117 \"https://nftstorage.link/ipfs/bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/78.jpg\" \"ipfs://bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/78.jpg\") (104 . 0x1a9152787d8374ececa0bf070b7a10e91162ada15964404d52232152f25b8b7a) (28021 \"https://nftstorage.link/ipfs/bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/metadata.json\" \"ipfs://bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/metadata.json\") (27765) (29550 . 1) (29556 . 1) (28008 . { "nft_info": { "chain_info": "((117 \"https://nftstorage.link/ipfs/bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/78.jpg\" \"ipfs://bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/78.jpg\") (104 . 0x1a9152787d8374ececa0bf070b7a10e91162ada15964404d52232152f25b8b7a) (28021 \"https://nftstorage.link/ipfs/bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/metadata.json\" \"ipfs://bafybeic32cwe43voxoybnwbayy7bedv4ip5tqho4jfol3xmtd62vscfoqa/metadata.json\") (27765) (29550 . 1) (29556 . 1) (28008 . 0xfdfe889a579916f8f75dcfff809eee44fc844df5fa92aecd2d562578e7e69a24))", "data_hash": "0x1a9152787d8374ececa0bf070b7a10e91162ada15964404d52232152f25b8b7a", @@ -2467,7 +2476,8 @@ The `ph` for the message payload can be any puzzlehash in your key derivation. O xch1ta7zjqqtaw9wyfnawl3z84a26vexr3qtmp7jq6gx4vpzl792sf9qddsacl ``` -This address still needs to be converted into a puzzlehash. This address still needs to be converted into a puzzlehash. One way to accomplish this is with an online converter, such as the one available from [spacescan](https://www.spacescan.io/tools/puzzlehashconverter). Another option is to use the `decode` command from the [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools) repository: Another option is to use the `decode` command from the [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools) repository: +This address still needs to be converted into a puzzlehash. One way to accomplish this is with an online converter, such as the one available from [spacescan](https://www.spacescan.io/tools/puzzlehashconverter). +Another option is to use the `decode` command from the [chia-dev-tools](https://github.com/Chia-Network/chia-dev-tools) repository: ```json cdv decode xch1ta7zjqqtaw9wyfnawl3z84a26vexr3qtmp7jq6gx4vpzl792sf9qddsacl @@ -2808,7 +2818,7 @@ Request Parameters: | batch_size | NUMBER | False | The number of coins to spend per bundle, [Default: `batch_size` obtainable from [get_auto_claim](#get_auto_claim)] | | fee | NUMBER | False | An optional blockchain fee, in mojos | -When examing the on-chain metadata for a transaction, a coin with `"type": 6` is a clawback coin to be received by this wallet, and a coin with `"type": 7` is a clawback coin sent from this wallet. +When examining the on-chain metadata for a transaction, a coin with `"type": 6` is a clawback coin to be received by this wallet, and a coin with `"type": 7` is a clawback coin sent from this wallet.
Example @@ -3210,7 +3220,7 @@ Response: ### `cat_get_asset_id` -功能： Retrieve a the asset ID from a CAT wallet +功能： Retrieve the asset ID from a CAT wallet 用法： chia rpc wallet [OPTIONS] cat_get_asset_id [REQUEST] diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md index 002f7baf37..1a0771251e 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/node-syncing.md @@ -6,27 +6,27 @@ slug: /troubleshooting/node-syncing import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -Port forwarding port 8444 can solve many sync issues and helps improve Chia's network health. +Forwarding port 8444 can solve many sync issues and it also helps improve Chia's overall network health. -Port 8444 is the [port](https://en.wikipedia.org/wiki/Port_%28computer_networking%29) through which other Chia computers can communicate with your PC. When you set up port forwarding on port 8444, the Chia software on your computer can quickly talk to other PCs, link up, and start downloading and syncing with the Chia blockchain. +Port 8444 is the [port](https://en.wikipedia.org/wiki/Port_%28computer_networking%29) through which other Chia nodes can communicate with your node. When you set up port forwarding on port 8444, the Chia software on your computer can easily communicate with other nodes and sync the Chia blockchain faster. -The network is undergoing rapid growth and expansion. Many of the newly arrived Chia peers (computers) do not open up port 8444. Therefore, it is strongly recommended that you enable port forwarding. +The network is undergoing rapid growth and expansion. Many newly arriving Chia nodes do not open port 8444, resulting in additional stress to the network. Therefore, it is strongly recommended that you enable port forwarding. -Use [this port checker](https://portchecker.co/) to check if your router's port 8444 is closed. +Use [this port checker](https://portchecker.co/) to check if you have port forwarding configured correctly. ## Port Forwarding Settings Port forwarding is done on your router. How you set it up depends on your router's make and model. Look through your router's manual or just search for "`` how to port forward" to get started. -When you port forward you want to allow outside IP addresses to connect to your main node (computer) through port 8444 to the Chia software. +When you enable port forwarding, you are allowing any system on the Internet to connect to your Chia node through port 8444 to the Chia software. Most routers will ask you from where you are allowing and to what you are connecting to. You want to set up port forwarding to allow any outside connection to connect to the IP address of your main node on your network through port 8444. Router manufacturers might call the settings different things, but the concept is always the same: Outside computers connecting through port 8444 to your computer. Here are the settings most routers will ask for: - Set connection type to _TCP_ or _TCP & UDP_ -- Destination (or Forwarding) IP address - This is your main node (computer) IP address on your internal network; search online on how to do this for your type of computer. If you search for "what is my IP address" it will give you your external IP address, this is not the one you want. -- Originating (or From) IP address - Set this to all or sometimes just an asterisk may be used `*` +- Destination (or forwarding) IP address - This is your main node (computer) IP address on your internal network; search online on how to do this for your type of computer. If you search for "what is my IP address" it will give you your external IP address, this is not the one you want. +- Originating (or from) IP address - Set this to all or sometimes just an asterisk may be used `*` ## Why forward port 8444? @@ -38,7 +38,7 @@ If you enable port forwarding, your node will sync faster, and you will be helpi If you would like to speed up connectivity to other nodes and increase your sync speed, add the introducer node to your Chia client: -\ -``` -- Mainnet Introducer: `introducer.chia.net:8444` + - Mainnet Introducer: `introducer.chia.net:8444` -Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. -- CNI Operated Full Node: `node.chia.net` + Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. + - CNI Operated Full Node: `node.chia.net` -Additionally, you can also visit either of the below websites that are frequently updated with available nodes listening on port 8444: -- [ChiaNodes.com](https://ChiaNodes.com) -- [chia.keva.app](https://chia.keva.app) -``` + Additionally, you can also visit either of the below websites that are frequently updated with available nodes listening on port 8444: + - [ChiaNodes.com](https://ChiaNodes.com) + - [chia.keva.app](https://chia.keva.app) -``` -- DNS Introducer: `dns-introducer-testnet11.chia.net` -- Legacy Introducer: `introducer-testnet11.chia.net:58444` + - DNS Introducer: `dns-introducer-testnet11.chia.net` + - Legacy Introducer: `introducer-testnet11.chia.net:58444` -Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. -- CNI Operated Full Node: `testnet11-node.chia.net` -``` + Note: please only use the CNI operated nodes as a last resort for connecting to peers, these nodes might be running different client versions and are not intended to be used as trusted full nodes. + - CNI Operated Full Node: `testnet11-node.chia.net` -Nodes (IPs) from these sites can be added in the GUI from the Full Node tab, select the Full Node button in the top right corner and then choose "Connect to Other Peers". These can be added in the GUI via the button, or via the CLI with `chia show -a PEER_ADDRESS:PORT` where `PORT` will usually be 8444. +Nodes (IPs) from these sites can be added in the GUI from the Full Node tab, select the Full Node button in the top right corner and then choose "Connect to Other Peers". You can also add nodes via the CLI with the command `chia peer full_node -a PEER_ADDRESS:PORT` where `PORT` will typically be 8444. ## Detailed explanation -A regular pc can communicate **out** with endless ports-- if the user is sending a signal out -- pc opens a port -- signal goes out, pc closes the port. Chia uses port 8444 as instant verified communication. So an open port can allow instant communication and start the blockchain sync. Signal comes in on port 8444- that Chia pc is verified, then **both** user's pc, opens their own "communication ports ex port 8421" and that new user can now sync and now they are linked together forming part of Chia mesh. +A regular pc can communicate out with endless ports-- if the user is sending a signal out -- pc opens a port -- signal goes out, pc closes the port. Chia uses port 8444 as instant verified communication. So an open port can allow instant communication and start the blockchain sync. Signal comes in on port 8444- that Chia pc is verified, then both user's pc, opens their own "communication ports ex port 8421" and that new user can now sync and now they are linked together forming part of Chia mesh. If the users port 8444 is closed, the users pc has to start sending multiple signals out and hope that a pc with open port 8444 will link with them, then the sync starts. (1) pc can only link up a few pc and with so many other Chia users coming on board, they all have to wait. Keep in mind, Chia is built on a mesh network, the blockchain is shared among all the users, not from central pc. ## Dealing With Carrier-Grade NAT -Opened port 8444 on your router but still not getting connections? With the exhaustion of the IPv4 space, it's increasingly common for ISPs to use [Carrier-Grade NAT](https://en.wikipedia.org/wiki/Carrier-grade_NAT) (CGN, CG-NAT, NAT444) to put multiple customers behind a single IP address. In this case, even if you open 8444 on your router, other nodes will not be able to connect to you. There are a couple options: +Have you opened port 8444 on your router but still not getting connections? With the exhaustion of the IPv4 network space, it's increasingly common for ISPs to use [Carrier-Grade NAT](https://en.wikipedia.org/wiki/Carrier-grade_NAT) (CGN, CG-NAT, NAT444) by placing multiple customers behind a single IP address. In this case, even if you open 8444 on your router, other nodes will not be able to connect to you. There are a couple options: -1. Ask your ISP for a dedicated IP address. They'll probably want more money, and may require you to upgrade to a "business" plan. +1. Ask your ISP for a dedicated IP address. They'll probably want more money and may require you to upgrade to a "business" plan. -2. Establish a VPN tunnel through the NAT to a cloud server with a public IP address. It's easier than it sounds, and can cost as little as $3-5 a month for a cheap cloud server (some common cloud server providers: AWS, GCP, Digital Ocean, Vultr, Hetzner, Linode). When selecting a provider and server size, pay careful attention to bandwidth; a Chia fullnode isn't too demanding, but can require several GB per day. 1 TB per month is typical of lower-cost VPSs and should be plenty (do keep an eye on it though, bandwidth overage costs can be expensive!). +2. Establish a VPN tunnel through the NAT to a cloud server with a public IP address. It's easier than it sounds and can cost as little as $3-5 a month for a cheap cloud server (some common cloud server providers: AWS, GCP, Digital Ocean, Vultr, Hetzner, Linode). When selecting a provider and server size, pay careful attention to bandwidth; a Chia fullnode isn't too demanding, but can require several GB per day. 1 TB per month is typical of lower-cost VPSs and should be plenty (do keep an eye on it though, bandwidth overage costs can be expensive!). Setting up a VPN used to be a daunting task, but [Wireguard](https://www.wireguard.com) has greatly simplified it. The summary is you run Wireguard on both your home server and the cloud server: -- the cloud server is configured to listen for VPN connections from your home server, and route all traffic incoming on 8444 to your home server, while also routing outgoing traffic from your home server to the internet. +- the cloud server is configured to listen for VPN connections from your home server and route all traffic incoming on 8444 to your home server, while also routing outgoing traffic from your home server to the internet. - the home server is configured to route all internet traffic (but not local) through the cloud server, while periodically sending a "keepalive" packet to ensure the connection stays open. Here is a more detailed write-up with [example wireguard configuration](https://www.kmr.me/posts/wireguard/). From eb7baa2a1e522084deaf145979d34c1fc3601a7b Mon Sep 17 00:00:00 2001 From: ClydeWallace22 <48610606+BrandtH22@users.noreply.github.com> Date: Wed, 24 Jul 2024 16:05:16 -0600 Subject: [PATCH 4/4] formatting fixes --- .../academy/academy-intro/academy-overview.md | 8 +- .../academy/chialisp/chialisp-intro.md | 2 +- .../current/block-validation/block-rewards.md | 12 +- .../current/cli-reference/asic-hwvdf.md | 22 +- .../current/cli-reference/cat-admin.md | 6 +- .../current/cli-reference/clawback.md | 12 +- .../current/cli-reference/custody-tool.md | 130 ++--- .../current/cli-reference/daos.md | 390 ++++++------- .../current/cli-reference/datalayer.md | 176 +++--- .../current/cli-reference/dids.md | 32 +- .../current/cli-reference/nfts.md | 18 +- .../current/cli-reference/offers.md | 8 +- .../current/cli-reference/plotters.md | 112 ++-- .../current/cli-reference/simulator.md | 14 +- .../current/cli-reference/vcs.md | 18 +- .../current/cli-reference/wallet.md | 44 +- .../current/coin-set-model/clvm-vs-evm.md | 20 +- .../current/coin-set-model/costs.md | 28 +- .../consensus/attacks-and-countermeasures.md | 4 +- .../current/consensus/forks.md | 14 +- .../consensus/signage-and-infusion-points.md | 12 +- .../current/farming/farming-basics.md | 2 +- .../current/farming/pool-farming.md | 2 +- .../current/getting-started/wallet-guide.md | 1 - .../constants-variables-notation.md | 32 +- .../green-paper/green-paper-introduction.md | 2 +- .../green-paper/green-paper-references.md | 12 +- .../current/green-paper/rational-attackers.md | 6 +- .../guides/cat/cat2-upgrade/cat2-issuance.md | 4 +- .../guides/clawback/clawback-user-guide.md | 2 +- .../current/guides/crash-course/chialisp.md | 2 +- .../guides/crash-course/intro-to-chialisp.md | 2 +- .../custody/custody-tool-description.md | 26 +- .../guides/custody/custody-tool-user-guide.md | 14 +- .../guides/datalayer/datalayer-permissions.md | 24 +- .../guides/datalayer/datalayer-user-guide.md | 2 +- .../current/guides/nft/nft-intro.md | 2 +- .../walletconnect-developer-guide.md | 86 +-- .../walletconnect/walletconnect-user-guide.md | 2 +- .../current/plotting/plotting-compression.md | 20 +- .../current/plotting/plotting-hardware.md | 14 +- .../current/plotting/plotting-how-to.md | 2 +- .../current/plotting/plotting-setup.md | 20 +- .../current/plotting/ssd-endurance.md | 16 +- .../pool/pool-protocol-specification.md | 4 +- .../reference-client/key-management.md | 2 +- .../resources/chia-farming-workload.md | 16 +- .../current/resources/faq.md | 6 +- .../current/resources/k-sizes.md | 40 +- .../current/rpc-reference/daemon.md | 122 ++-- .../current/rpc-reference/daos.md | 136 ++--- .../current/rpc-reference/datalayer.md | 186 +++--- .../current/rpc-reference/dids.md | 112 ++-- .../current/rpc-reference/farmer.md | 54 +- .../current/rpc-reference/full-node.md | 124 ++-- .../current/rpc-reference/harvester.md | 20 +- .../current/rpc-reference/nfts.md | 134 ++--- .../current/rpc-reference/offers.md | 74 +-- .../current/rpc-reference/simulator.md | 46 +- .../current/rpc-reference/vcs.md | 46 +- .../current/rpc-reference/wallet.md | 530 +++++++++--------- .../troubleshooting/logging-reference.md | 156 +++--- .../current/walletconnect/general.md | 40 +- .../current/walletconnect/nfts.md | 62 +- .../current/walletconnect/offers.md | 6 +- 65 files changed, 1647 insertions(+), 1646 deletions(-) diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md index 724739abfb..e8a8ff4060 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/academy-intro/academy-overview.md @@ -132,10 +132,10 @@ Chia学院的课程页面经过精心设计，以增强学生的学习体验。 所有适用的课程都提供了Chialisp和clvm的可运行插件。 花些时间熟悉这些工具，并学习如何在整个课程中最好地利用它们。 每个插件都有一系列组件： -**语言：** 插件的语言（Chialisp或clvm）位于右上角。 -**解决方案(Solution)：** 顶部部分是输入或解决方案。 -**谜题(Puzzle)：** 底部部分是谜题。 -**运行：** 每个插件在语言标识符右侧都有一个播放/运行按钮。 +**语言：** 插件的语言（Chialisp或clvm）位于右上角。 +**解决方案(Solution)：** 顶部部分是输入或解决方案。 +**谜题(Puzzle)：** 底部部分是谜题。 +**运行：** 每个插件在语言标识符右侧都有一个播放/运行按钮。 **结果：** 单击运行后，谜题的结果将出现在谜题下方。 :::info diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md index c56c81ed0d..1aeacb7250 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/academy/chialisp/chialisp-intro.md @@ -78,7 +78,7 @@ So let's get started, the first thing you'll want to do is make sure you have th ## 常见问题 - **run vs brun:** `run` 用于序列化并运行 Chialisp 谜题，而 `brun` 用于运行 clvm 序列化的谜题，通常用于传递参数。 -- **括号（Parentheses）：**Chialisp 是完全括号前缀表示法编程语言家族的一部分，可以[追溯](https://en.wikipedia.org/wiki/Lisp_(programming_language))到上世纪 50 年代的 LISP 1。 这些语言的一个显而易见的特点是它们使用括号来表示列表（lists）。 建议在编写这些语言时使用具有适当语法高亮功能的集成开发环境，以确保所有括号都处于正确的位置。 为了帮助解决这个问题，这里有一个适用于 Visual Studio 的 [Chialisp 语言服务器扩展](https://marketplace.visualstudio.com/items?itemName=ChiaNetwork.chialisp)。 +- **括号（Parentheses）：**Chialisp 是完全括号前缀表示法编程语言家族的一部分，可以[追溯]()到上世纪 50 年代的 LISP 1。 这些语言的一个显而易见的特点是它们使用括号来表示列表（lists）。 建议在编写这些语言时使用具有适当语法高亮功能的集成开发环境，以确保所有括号都处于正确的位置。 为了帮助解决这个问题，这里有一个适用于 Visual Studio 的 [Chialisp 语言服务器扩展](https://marketplace.visualstudio.com/items?itemName=ChiaNetwork.chialisp)。 - **前缀表示法：**Chialisp 作为 LISP 家族的一部分，使用前缀表示法。 这意味着函数或运算符首先出现，其参数紧随其后。 --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md index 720f2c288a..5b0bdd8932 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/block-validation/block-rewards.md @@ -48,11 +48,11 @@ The second coin, with 7/8 of the value, is called the _pool coin_. This coin can As detailed in the [Business white paper](https://www.chia.net/whitepaper), the network's emissions schedule is as follows: | Years | Final
Block | Final Month
(Approx.) | Block Reward
(total) | Pool
Reward | Farmer
Reward | -| -------:| ---------------------:| -------------------------------:| ------------------------------:| ---------------------:| -----------------------:| -| 1 - 3 | `5 045 760` | March 2024 | 2 XCH | 1.75 XCH | 0.25 XCH | -| 4 - 6 | `10 091 520` | March 2027 | 1 XCH | 0.785 XCH | 0.125 XCH | -| 7 - 9 | `15 137 280` | March 2030 | 0.5 XCH | 0.4375 XCH | 0.0625 XCH | -| 10 - 12 | `20 183 040` | March 2033 | 0.25 XCH | 0.21875 XCH | 0.03125 XCH | -| 13 - ∞ | ∞ | ∞ | 0.125 XCH | 0.109375 XCH | 0.015625 XCH | +| ------: | --------------: | ------------------------: | -----------------------: | --------------: | ----------------: | +| 1 - 3 | `5 045 760` | March 2024 | 2 XCH | 1.75 XCH | 0.25 XCH | +| 4 - 6 | `10 091 520` | March 2027 | 1 XCH | 0.785 XCH | 0.125 XCH | +| 7 - 9 | `15 137 280` | March 2030 | 0.5 XCH | 0.4375 XCH | 0.0625 XCH | +| 10 - 12 | `20 183 040` | March 2033 | 0.25 XCH | 0.21875 XCH | 0.03125 XCH | +| 13 - ∞ | ∞ | ∞ | 0.125 XCH | 0.109375 XCH | 0.015625 XCH | Note that the rewards are adjusted according to a block height, not a timestamp. Note that the rewards are adjusted according to a block height, not a timestamp. The `Final Block` column is therefore accurate as the last block before the rewards are modified. The months and years are only estimates based on when the block heights are likely to be reached. The months and years are only estimates based on when the block heights are likely to be reached. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md index dde1107ab6..ea897999ee 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/asic-hwvdf.md @@ -17,17 +17,17 @@ Usage: hw_vdf_client [OPTIONS] PORT [N_VDFS] Options: -| Long Command | Type | Required | Description | -| :----------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------- | -| --freq | INTEGER | False | set ASIC frequency [%d, 200 - 2200] | -| --voltage | INTEGER | False | set board voltage [.88, 0.7 - 1.0] | -| --ip | TEXT | False | timelord IP address [localhost] | -| --vdfs-mask | TEXT | False | mask for enabling VDF engines [7, 1 - 7] | -| --vdf-threads | TEXT | False | number of software threads per VDF engine [4, 2 - 64] | -| --proof-threads | TEXT | False | number of proof threads per VDF engine [3, 1 - 63] | -| --auto-freq-period | TEXT | False | auto-adjust frequency every N seconds [0, 10 - inf] | -| --list | TEXT | False | list available devices and exit | -| --help | None | False | Show a help message and exit | +| Long Command | Type | Required | Description | +| :----------------- | :------ | :------- | :---------------------------------------------------- | +| --freq | INTEGER | False | set ASIC frequency [%d, 200 - 2200] | +| --voltage | INTEGER | False | set board voltage [.88, 0.7 - 1.0] | +| --ip | TEXT | False | timelord IP address [localhost] | +| --vdfs-mask | TEXT | False | mask for enabling VDF engines [7, 1 - 7] | +| --vdf-threads | TEXT | False | number of software threads per VDF engine [4, 2 - 64] | +| --proof-threads | TEXT | False | number of proof threads per VDF engine [3, 1 - 63] | +| --auto-freq-period | TEXT | False | auto-adjust frequency every N seconds [0, 10 - inf] | +| --list | TEXT | False | list available devices and exit | +| --help | None | False | Show a help message and exit |
Example 1 - Run the ASIC software with defaults diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md index 34bce54639..acb336d582 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/cat-admin.md @@ -24,7 +24,7 @@ Usage: cats [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -l | --tail | TEXT | True | The TAIL program to launch this CAT with | | -c | --curry | TEXT | False | An argument to curry into the TAIL | | -s | --solution | TEXT | False | The solution to the TAIL program [default: ()] | @@ -186,7 +186,7 @@ Usage: secure_the_bag [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -c | --curry | TEXT | False | An argument to curry into the TAIL | | -a | --amount | INTEGER | True | The amount to issue in mojos (regular XCH will be used to fund this) | | -stbtp | --secure-the-bag-targets-path | TEXT | True | Path to CSV file containing targets of secure the bag (inner puzzle hash + amount). The total value of the coins in this file must match the value of the `amount` flag. If they don't match, an error will be thrown. | @@ -222,7 +222,7 @@ Usage: secure_the_bag [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------- | +| :------------ | :---------------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------- | | -ecid | --eve-coin-id | TEXT | True | ID of coin that was spent to create secured bag | | -th | --tail-hash | TEXT | True | TAIL hash / Asset ID of CAT to unwind from secured bag of CATs | | -stbtp | --secure-the-bag-targets-path | TEXT | True | Path to CSV file containing targets of secure the bag (inner puzzle hash + amount) | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md index 99791ba0d8..84ebeaa53a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/clawback.md @@ -36,14 +36,14 @@ Usage: `clawback [OPTIONS] COMMAND [ARGS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:---------------------------- | +| :------------ | :----------- | :--- | :------- | :--------------------------- | | | --version | None | False | Show the version and exit | | -h | --help | None | False | Show a help message and exit | Commands: | Name | Description | -|:------ |:--------------------------------------------------- | +| :----- | :-------------------------------------------------- | | claim | Claim a clawback coin after the timelock has passed | | claw | Clawback an unclaimed coin | | create | Send xch to a clawback coin | @@ -60,7 +60,7 @@ Usage: `clawback claim [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -c | --coin-id | TEXT | True | The coin ID you want to claim | | -m | --fee | FLOAT | False | The fee in XCH for this transaction | | -w | --wallet-id | INTEGER | False | The wallet id for fees. If no target address given the clawback will go to this wallet id | @@ -245,7 +245,7 @@ Usage: `clawback claw [OPTIONS]` Options: Clawback an unclaimed coin | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -c | --coin-id | TEXT | True | The coin ID for the clawback coin to inspect | | -m | --fee | FLOAT | False | The fee in XCH for this transaction | | -w | --wallet-id | INTEGER | False | The wallet id for fees. If no target address given the clawback will go to this wallet id | @@ -317,7 +317,7 @@ Usage: `clawback create [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -t | --to | TEXT | True | The recipient's address | | -l | --timelock | INTEGER | False | The timelock to use for the clawback coin you're creating, in seconds. Default is two weeks | | -a | --amount | INTEGER | True | The amount to fund (in XCH) | @@ -410,7 +410,7 @@ Usage: `clawback show [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -c | --coin-id | TEXT | False | The coin ID for the clawback coin to inspect | | -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md index 5cc8e3fe18..4050333a87 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/custody-tool.md @@ -25,12 +25,12 @@ Usage: `cic audit [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filepath | TEXT | False | The file path the dump the audit log | -| -d | --diff | TEXT | False | A previous audit log to diff against this one | -| -h | --help | None | False | Show a help message and exit | +| -f | --filepath | TEXT | False | The file path the dump the audit log | +| -d | --diff | TEXT | False | A previous audit log to diff against this one | +| -h | --help | None | False | Show a help message and exit |
Example @@ -102,12 +102,12 @@ Usage: `cic clawback [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | -| -h | --help | None | False | Show a help message and exit | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | +| -h | --help | None | False | Show a help message and exit |
Example @@ -134,11 +134,11 @@ Usage: `cic complete [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -h | --help | None | False | Show a help message and exit | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -h | --help | None | False | Show a help message and exit |
Example -- complete a withdrawal @@ -172,7 +172,7 @@ Usage: `cic derive_root [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:-------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | | -c | --configuration | TEXT | False | The configuration file with which to derive the root (or the filepath to create it at if using --db-path) [default: ./Configuration (needs derivation).txt] | | -db | --db-path | TEXT | False | Optionally specify a DB path to find the configuration from | | -pks | --pubkeys | TEXT | True | A comma separated list of pubkey files that will control this money | @@ -210,7 +210,7 @@ Usage: `cic examine_spend [OPTIONS] SPEND_FILE` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------------ |:------- |:-------- |:---------------------------------------------------------------- | +| :------------ | :----------------- | :------ | :------- | :--------------------------------------------------------------- | | | --qr-density | INTEGER | False | The amount of bytes to pack into a single QR code [default: 250] | | -va | --validate-against | TEXT | False | A new configuration file to check against requests for rekeys | | -h | --help | None | False | Show a help message and exit | @@ -249,12 +249,12 @@ Usage: `cic export_config [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:--------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :--- | :------- | :-------------------------------------------------------------------------------------------- | | -f | --filename | TEXT | False | The file path to export the config to (default: ./Configuration Export (\*\*\*\*\*\*).sqlite) | | -db | --db-path | TEXT | True | The file path to initialize/find the sync database at (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -p | --public | None | False | Enable to export the public information only (default: disabled) | -| -h | --help | None | False | Show a help message and exit | +| -p | --public | None | False | Enable to export the public information only (default: disabled) | +| -h | --help | None | False | Show a help message and exit |
Example -- export the config to export.bin @@ -283,12 +283,12 @@ Usage: `cic increase_security_level [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -h | --help | None | False | Show a help message and exit | +| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -h | --help | None | False | Show a help message and exit |
Example -- move to a 4-of-5 config @@ -318,7 +318,7 @@ Usage: `cic init [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------------- |:---- |:-------- |:--------------------------------------------------------------------------------------------------- | +| :------------ | :-------------------- | :--- | :------- | :-------------------------------------------------------------------------------------------------- | | -d | --directory | TEXT | False | The directory in which to create the configuration file [default: .] | | -wt | --withdrawal-timelock | TEXT | True | The amount of time where nothing has happened before a withdrawal can be made (in seconds) | | -pc | --payment-clawback | TEXT | True | The amount of time to clawback a payment before it's completed (in seconds) | @@ -354,15 +354,15 @@ Usage: `cic launch_singleton [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------- | -| -c | --configuration | TEXT | True | The configuration file with which to launch the singleton | -| -db | --db-path | TEXT | True | The file path to initialize the sync database at | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------- | +| -c | --configuration | TEXT | True | The configuration file with which to launch the singleton | +| -db | --db-path | TEXT | True | The file path to initialize the sync database at | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | -| | --fee | INTEGER | False | Fee to use for the launch transaction (in mojos) [default: 0] | -| -h | --help | None | False | Show a help message and exit | +| | --fee | INTEGER | False | Fee to use for the launch transaction (in mojos) [default: 0] | +| -h | --help | None | False | Show a help message and exit |
Example @@ -391,11 +391,11 @@ Usage: `cic p2_address [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:-------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -p | --prefix | TEXT | False | The prefix to use when encoding the address (default: xch) | -| -h | --help | None | False | Show a help message and exit | +| -p | --prefix | TEXT | False | The prefix to use when encoding the address (default: xch) | +| -h | --help | None | False | Show a help message and exit |
Example @@ -423,8 +423,8 @@ Usage: `cic payment [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------ | -| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | +| :------------ | :-------------------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------- | +| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | | -f | --filename | TEXT | False | The filepath to dump the spend bundle into | | -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | | -a | --amount | INTEGER | False | The outgoing amount (in mojos) to pay [default: 0] | @@ -463,14 +463,14 @@ Usage: `cic push_tx [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------- | -| -b | --spend-bundle | TEXT | True | The signed spend bundle | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------- | +| -b | --spend-bundle | TEXT | True | The signed spend bundle | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | -| -m | --fee | INTEGER | False | The fee to attach to this spend (in mojos) | -| -h | --help | None | False | Show a help message and exit | +| -m | --fee | INTEGER | False | The fee to attach to this spend (in mojos) | +| -h | --help | None | False | Show a help message and exit |
Example @@ -500,8 +500,8 @@ Usage: `cic show [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------------------- | -| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (**\*\***).sqlite) [required] | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------------------ | +| -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (**\*\***).sqlite) [required] | | -c | --config | None | False | Enable to display the details of the public config (default: disabled) | | -d | --derivation | None | False | Enable to display the private details of the private config (default: disabled) | | -h | --help | None | False | Show a help message and exit | @@ -561,13 +561,13 @@ Usage: `cic start_rekey [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:------------------- |:---- |:-------- |:-------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------ | :--- | :------- | :------------------------------------------------------------------- | | -db | --db-path | TEXT | True | The file path to the sync DB (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | -| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | -| -new | --new-configuration | TEXT | True | The configuration you would like to rekey the singleton to | -| -h | --help | None | False | Show a help message and exit | +| -f | --filename | TEXT | False | The filepath to dump the spend bundle into | +| -pks | --pubkeys | TEXT | True | A comma separated list of pubkeys that will be signing this spend | +| -new | --new-configuration | TEXT | True | The configuration you would like to rekey the singleton to | +| -h | --help | None | False | Show a help message and exit |
Example @@ -596,13 +596,13 @@ Usage: `cic sync [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------ | | -c | --configuration | TEXT | False | The configuration file with which to initialize a sync database (default: ./Configuration (\*\*\*\*\*\*).txt) | | -db | --db-path | TEXT | True | The file path to initialize/find the sync database at (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | -| -s | --show | None | False | Enable to show a summary of the singleton after sync is complete (default: disabled) | -| -h | --help | None | False | Show a help message and exit | +| -np | --node-rpc-port | INTEGER | False | Set the port where the Node is hosting the RPC interface. See the rpc_port under full_node in config.yaml | +| -s | --show | None | False | Enable to show a summary of the singleton after sync is complete (default: disabled) | +| -h | --help | None | False | Show a help message and exit |
Example -- sync and show the config @@ -642,11 +642,11 @@ Usage: `cic update_config [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:---- |:-------- |:------------------------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :--- | :------- | :------------------------------------------------------------------------------------------------------------ | | -c | --configuration | TEXT | False | The configuration file with which to initialize a sync database (default: ./Configuration (\*\*\*\*\*\*).txt) | | -db | --db-path | TEXT | True | The file path to initialize/find the sync database at (default: ./sync (\*\*\*\*\*\*).sqlite) | -| -h | --help | None | False | Show a help message and exit | +| -h | --help | None | False | Show a help message and exit |
Example -- update config after rekey @@ -676,7 +676,7 @@ Usage: `cic which_pubkeys [OPTIONS] AGGREGATE_PUBKEY` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------- |:------- |:-------- |:------------------------------------------------------------------- | +| :------------ | :------------ | :------ | :------- | :------------------------------------------------------------------ | | -pks | --pubkeys | TEXT | True | A comma separated list of pubkey files that may be in the aggregate | | -m | --num-pubkeys | INTEGER | False | Check only combinations of a specific number of pubkeys | | | --no-offset | None | False | Do not try the synthetic versions of the pubkeys | @@ -789,7 +789,7 @@ Positional arguments: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:-------------------- |:---- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :------------------- | :--- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------- | | -y | --yes | None | False | Enable to skip confirmations (default: disabled) | | | --qr | None | False | Enable to show signature as QR code (default: disabled) | | | --nochunks | None | False | Enable to read the spend in its entirety rather than as chunks (testing only) argument to pass to gpg (besides -d). (default: disabled) | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md index 76245018ae..1006d8ada3 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/daos.md @@ -27,14 +27,14 @@ Usage: chia dao add \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -n | --name | TEXT | False | Set the DAO wallet name | -| -t | --treasury-id | TEXT | True | The Treasury ID of the DAO you want to track | -| -a | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -n | --name | TEXT | False | Set the DAO wallet name | +| -t | --treasury-id | TEXT | True | The Treasury ID of the DAO you want to track | +| -a | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | +| -h | --help | None | False | Show a help message and exit |
Example @@ -136,21 +136,21 @@ Usage: chia dao add_funds \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO Treasury Wallet | -| -w | --funding-wallet-id | INTEGER | True | The ID of the wallet to send funds from (must be of type `STANDARD_WALLET`) | -| -a | --amount | TEXT | True | The amount of funds to send, in XCH | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO Treasury Wallet | +| -w | --funding-wallet-id | INTEGER | True | The ID of the wallet to send funds from (must be of type `STANDARD_WALLET`) | +| -a | --amount | TEXT | True | The amount of funds to send, in XCH | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -251,12 +251,12 @@ Usage: chia dao balance \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -283,21 +283,21 @@ Usage: chia dao close_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | | -d | --self-destruct | None | False | If this flag is set, it will self-destruct a broken proposal, thus forcing to force it to close \[default: not set] | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | | | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | | | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -410,29 +410,29 @@ Usage: chia dao create \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -n | --name | TEXT | False | Set the DAO wallet name | -| | --proposal-timelock | INTEGER | False | The minimum number of blocks before a proposal can close \[default: 1000] | -| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing \[default: 20] | -| | --attendance-required | INTEGER | True | The minimum number of votes a proposal must receive to be accepted | -| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 \[default: 5000] | -| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed \[default: 10000] | -| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury \[default: 50] | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -n | --name | TEXT | False | Set the DAO wallet name | +| | --proposal-timelock | INTEGER | False | The minimum number of blocks before a proposal can close \[default: 1000] | +| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing \[default: 20] | +| | --attendance-required | INTEGER | True | The minimum number of votes a proposal must receive to be accepted | +| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 \[default: 5000] | +| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed \[default: 10000] | +| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury \[default: 50] | | | --proposal-minimum | INTEGER | False | The minimum amount (in xch) that a proposal must use to be created (this is a spam-prevention measure; it will be donated to the treasury when the proposal is closed) \[default: 0.000000000001] | -| | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | -| | --cat-amount | INTEGER | True | The number of DAO CATs (in mojos) to create when initializing the DAO | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --fee-for-cat | TEXT | False | Set the fees for the CAT creation transaction, in XCH \[default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| | --filter-amount | INTEGER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | +| | --cat-amount | INTEGER | True | The number of DAO CATs (in mojos) to create when initializing the DAO | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --fee-for-cat | TEXT | False | Set the fees for the CAT creation transaction, in XCH \[default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | :::info @@ -563,22 +563,22 @@ Usage: chia dao create_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | -| -a | --amount | INTEGER | True | The amount of new cats the proposal will mint (in mojos) | -| -t | --to-address | TEXT | True | The address new cats will be minted to | -| -v | --vote-amount | INTEGER | True | The number of votes to add | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | +| -a | --amount | INTEGER | True | The amount of new cats the proposal will mint (in mojos) | +| -t | --to-address | TEXT | True | The address new cats will be minted to | +| -v | --vote-amount | INTEGER | True | The number of votes to add | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | :::warning @@ -682,24 +682,24 @@ Usage: chia dao create_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -t | --to-address | TEXT | False | The address the proposal will send funds to | -| -a | --amount | FLOAT | False | The amount of funds the proposal will send (in mojos) | -| -v | --vote-amount | INTEGER | True | The number of votes to add | -| | --asset-id | TEXT | False | The asset id of the funds the proposal will send. Leave blank for xch | -| -j | --from-json | TEXT | False | Path to a json file containing a list of additions, for use in proposals with multiple spends | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -t | --to-address | TEXT | False | The address the proposal will send funds to | +| -a | --amount | FLOAT | False | The amount of funds the proposal will send (in mojos) | +| -v | --vote-amount | INTEGER | True | The number of votes to add | +| | --asset-id | TEXT | False | The asset id of the funds the proposal will send. Leave blank for xch | +| -j | --from-json | TEXT | False | Path to a json file containing a list of additions, for use in proposals with multiple spends | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -818,26 +818,26 @@ Usage: chia dao create_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -v | --vote-amount | INTEGER | True | The number of votes to add | -| | --proposal-timelock | INTEGER | False | The new minimum number of blocks before a proposal can close | -| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing | -| | --attendance-required | INTEGER | False | The minimum number of votes a proposal must receive to be accepted | -| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | -| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed | -| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -v | --vote-amount | INTEGER | True | The number of votes to add | +| | --proposal-timelock | INTEGER | False | The new minimum number of blocks before a proposal can close | +| | --soft-close | INTEGER | False | The number of blocks a proposal must remain unspent before closing | +| | --attendance-required | INTEGER | False | The minimum number of votes a proposal must receive to be accepted | +| | --pass-percentage | INTEGER | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | +| | --self-destruct | INTEGER | False | The number of blocks required before a proposal can be automatically removed | +| | --oracle-delay | INTEGER | False | The number of blocks required between oracle spends of the treasury | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -908,19 +908,19 @@ Usage: chia dao exit_lockup \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet from which to exit the lockup | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet from which to exit the lockup | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | This command will unlock tokens that have been locked for voting, provided that there are no active proposals that these CATs have voted on. This command will automatically determine which CATs are available to be unlocked. @@ -1005,12 +1005,12 @@ Usage: chia dao get_id \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet which will receive the funds | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet which will receive the funds | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1039,13 +1039,13 @@ Usage: chia dao list_proposals \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -c | --include-closed | None | False | Set to include previously closed proposals \[Default: not set] | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -c | --include-closed | None | False | Set to include previously closed proposals \[Default: not set] | +| -h | --help | None | False | Show a help message and exit | This command will list all open proposals by default. If the `-c` flag is included, then all open _and_ closed proposals will be listed. @@ -1083,20 +1083,20 @@ Usage: chia dao lockup_coins \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | -| -a | --amount | TEXT | True | The amount of CATs (not mojos) to lock in voting mode | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the DAO wallet to use | +| -a | --amount | TEXT | True | The amount of CATs (not mojos) to lock in voting mode | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit | This command will lock the specified number of tokens, thereby making them available for voting. @@ -1215,19 +1215,19 @@ Usage: chia dao release_coins \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1308,12 +1308,12 @@ Usage: chia dao rules \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1346,13 +1346,13 @@ Usage: chia dao show_proposal \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :--------------------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -p | --proposal_id | TEXT | True | The ID of the proposal to fetch, obtainable by running the [list_proposals](#list_proposals) command | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -p | --proposal_id | TEXT | True | The ID of the proposal to fetch, obtainable by running the [list_proposals](#list_proposals) command | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1391,22 +1391,22 @@ Usage: chia dao vote \[OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -i | --wallet-id | INTEGER | True | ID of the wallet to use | -| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | -| -a | --vote-amount | INTEGER | True | The number of votes you want to cast | -| -n | --vote-no | None | False | Use this option to vote against a proposal. If not present then the vote is for the proposal | -| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | -| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | -| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | -| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | -| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | -| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | -| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------------------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -i | --wallet-id | INTEGER | True | ID of the wallet to use | +| -p | --proposal-id | TEXT | True | The ID of the proposal you are voting on | +| -a | --vote-amount | INTEGER | True | The number of votes you want to cast | +| -n | --vote-no | None | False | Use this option to vote against a proposal. If not present then the vote is for the proposal | +| -m | --fee | TEXT | False | Set the fees per transaction, in XCH [default: 0] | +| | --reuse, --reuse-puzhash | None | False | Set either of these flags to reuse the existing address for the change \[default: not set] | +| | --new-address, --generate-new-puzhash | None | False | Set either of these flags to generate a new puzzle hash / address for the change \[default: not set] | +| -ma | --min-coin-amount, --min-amount | TEXT | False | Ignore coins worth less then this much XCH or CAT units | +| -l | --max-coin-amount, --max-amount | TEXT | False | Ignore coins worth more then this much XCH or CAT units | +| | --exclude-coin | TEXT | False | Exclude the coin with this ID from being spent | +| | --exclude-amount | TEXT | False | Exclude any coins with this XCH or CAT amount from being included | +| -h | --help | None | False | Show a help message and exit |
Example diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md index db33a5c504..261279b11b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/datalayer.md @@ -40,7 +40,7 @@ Usage: `chia data add_mirror [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------- | | -i | --id | TEXT | True | The hexadecimal ID of the store to mirror | | -a | --amount | INTEGER | True | The amount (in mojos) to spend to create the mirror. In theory, mirrors with a higher `amount` will be prioritized. Minimum `amount` is 0 | | -u | --url | TEXT | False | A URL where the mirror will reside. Can be repeated to add multiple URLs in the same command | @@ -76,15 +76,15 @@ Usage: `chia data add_missing_files [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------- | -| -i | --ids | TEXT | True | The hexadecimal store id(s) | -| -o | --override | None | False | If set, will overwrite files that already exist (default: not set) | -| -n | --no-override | None | False | If set, will not overwrite files that already exist (default: set) | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------- | +| -i | --ids | TEXT | True | The hexadecimal store id(s) | +| -o | --override | None | False | If set, will overwrite files that already exist (default: not set) | +| -n | --no-override | None | False | If set, will not overwrite files that already exist (default: set) | | -d | --directory | TEXT | False | If specified, use a non-default directory to write the files (default: `~/.chia/mainnet/data_layer/db/server_files_location_`) | -| -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Fingerprint of the wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | +| -f | --fingerprint | INTEGER | False | Fingerprint of the wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -158,13 +158,13 @@ Usage: `chia data clear_pending_roots [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -i | --id | TEXT | True | The ID of the store from which to clear the pending roots | -| | --yes | None | False | Set to confirm the action without prompting [Default: not set / prompt to confirm] | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -i | --id | TEXT | True | The ID of the store from which to clear the pending roots | +| | --yes | None | False | Set to confirm the action without prompting [Default: not set / prompt to confirm] | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -201,13 +201,13 @@ Usage: `chia data create_data_store [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:--------:|:------------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------: | :---------------------------------------------------------------------------------------------------------- | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | -| | --verbose | None | False | Set to enable verbose output | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | +| | --verbose | None | False | Set to enable verbose output | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -352,13 +352,13 @@ Usage: `chia data delete_mirror [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -c | --coin_id | TEXT | True | The coin_id of the mirror to delete (obtainable from the [get_mirrors](#get_mirrors) command) | -| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -c | --coin_id | TEXT | True | The coin_id of the mirror to delete (obtainable from the [get_mirrors](#get_mirrors) command) | +| -m | --fee | TEXT | False | Set the fees for the transaction, in XCH | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -385,15 +385,15 @@ Usage: `chia data get_keys [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | -| -r | --root_hash | TEXT | False | The hexadecimal root hash | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | +| -r | --root_hash | TEXT | False | The hexadecimal root hash | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | -| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | +| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | +| -h | --help | None | False | Show a help message and exit | :::info @@ -434,15 +434,15 @@ Usage: `chia data get_keys_values [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | -| -r | --root_hash | TEXT | False | The hexadecimal root hash | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | +| -r | --root_hash | TEXT | False | The hexadecimal root hash | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | -| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | +| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | +| -h | --help | None | False | Show a help message and exit | :::info @@ -493,16 +493,16 @@ Usage: `chia data get_kv_diff [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store ID | -| -hash_1 | --hash_1 | TEXT | True | The first hash to compare | -| -hash_2 | --hash_2 | TEXT | True | The second hash to compare | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store ID | +| -hash_1 | --hash_1 | TEXT | True | The first hash to compare | +| -hash_2 | --hash_2 | TEXT | True | The second hash to compare | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | -| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -p | --page | INTEGER | False | Enables pagination of the output and requests a specific page | +| | --max-page-size | INTEGER | False | Set how many bytes to be included in a page, if pagination is enabled [Default: 40 MB] | +| -h | --help | None | False | Show a help message and exit | :::info @@ -552,7 +552,7 @@ Usage: `chia data get_mirrors [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -i | --id | TEXT | True | The hexadecimal ID of the store for which to get mirrors | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -598,7 +598,7 @@ Usage: `chia data get_owned_stores [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -h | --help | None | False | Show a help message and exit | @@ -637,7 +637,7 @@ Usage: `chia data get_proof [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -store | --id | TEXT | True | The hexadecimal store id | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -k | --key | TEXT | True | The hexadecimal key | @@ -690,12 +690,12 @@ Usage: `chia data get_root [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -727,12 +727,12 @@ Usage: `chia data get_root_history [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -788,11 +788,11 @@ Usage: `chia data get_subscriptions [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit |
Example @@ -830,12 +830,12 @@ Usage: `chia data get_sync_status [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| -h | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| -h | --help | None | False | Show a help message and exit | If the `root_hash` matches the `target_root_hash`, then the store is synced. @@ -872,14 +872,14 @@ Usage: `chia data get_value [OPTIONS]` Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -store | --id | TEXT | True | The hexadecimal store id | -| -k | --key | TEXT | True | The hexadecimal key | -| -r | --root_hash | TEXT | False | The hexadecimal root hash | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :-------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | +| -store | --id | TEXT | True | The hexadecimal store id | +| -k | --key | TEXT | True | The hexadecimal key | +| -r | --root_hash | TEXT | False | The hexadecimal root hash | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under data_layer in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | -| | --help | None | False | Show a help message and exit | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| | --help | None | False | Show a help message and exit |
Example @@ -912,7 +912,7 @@ Commands: `check` (Calls the plugin_info endpoint on all configured plugins) Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:---------------------------- | +| :------------ | :----------- | :--- | :------- | :--------------------------- | | -h | --help | None | False | Show a help message and exit | Note that currently `check` is the only sub-command under the `plugins` command. This command is shown in the example. @@ -949,7 +949,7 @@ Usage: `chia data remove_subscription [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -store | --id | TEXT | True | The hexadecimal ID of the store to which you would like to subscribe | | -u | --url | TEXT | False | A URL where the data store resides. This argument can be used multiple times in the same command | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | @@ -982,7 +982,7 @@ Usage: `chia data subscribe [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -store | --id | TEXT | True | The hexadecimal ID of the store to which you would like to subscribe | | -u | --url | TEXT | False | A URL where the data store resides. This argument can be used multiple times in the same command | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | @@ -1070,7 +1070,7 @@ Usage: `chia data unsubscribe [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -store | --id | TEXT | True | The hexadecimal ID of the store to which you would like to unsubscribe | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1115,7 +1115,7 @@ Usage: `chia data update_data_store [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -store | --id | TEXT | True | The hexadecimal store ID | | -d | --changelist | TEXT | True | A JSON object representing the changelist | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | @@ -1316,7 +1316,7 @@ Usage: `chia data verify_proof [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -p | --proof | TEXT | True | Proof to validate in JSON format | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1383,7 +1383,7 @@ Usage: `chia data wallet_log_in [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------- | +| :------------ | :-------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------ | | -dp | --data-rpc-port | INTEGER | False | Set the port where the DataLayer is hosting the RPC interface. See rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | True | Fingerprint of the wallet to use | | -h | --help | None | False | Show a help message and exit | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md index 438376e431..352b5c260c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/dids.md @@ -20,7 +20,7 @@ Usage: chia wallet did create [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -n | --name | TEXT | False | Set the DID wallet name [default: None] | @@ -85,15 +85,15 @@ Usage: chia wallet did find_lost [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -id | --coin_id | TEXT | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | -| -m | --metadata | TEXT | False | The new whole metadata in json format | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | +| -id | --coin_id | TEXT | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | +| -m | --metadata | TEXT | False | The new whole metadata in json format | | -r | --recovery_list_hash | TEXT | False | Override the recovery list hash of the DID. Only set this if your last DID spend updated the recovery list | -| -n | --num_verification | INTEGER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | -| -h | --help | None | False | Show a help message and exit. | +| -n | --num_verification | INTEGER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | +| -h | --help | None | False | Show a help message and exit. |
Example @@ -123,7 +123,7 @@ Usage: chia wallet did get_details [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | | -id | --coin_id | TEXT | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | @@ -170,7 +170,7 @@ Usage: chia wallet did get_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the wallet to use | @@ -205,7 +205,7 @@ Usage: chia wallet did message_spend [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:---------------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :--------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the wallet to use | @@ -254,7 +254,7 @@ Usage: chia wallet did get_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the wallet to use | @@ -323,7 +323,7 @@ Usage: chia wallet did sign_message [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --did_id | TEXT | True | DID ID you want to use for signing | @@ -358,7 +358,7 @@ Usage: chia wallet did transfer [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the DID wallet to transfer | @@ -435,7 +435,7 @@ Usage: chia wallet did update_metadata [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | ID of the DID wallet to use | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md index 26f3a28f4f..9e659d3a53 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/nfts.md @@ -18,7 +18,7 @@ Usage: chia wallet nft create [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -di | --did-id | TEXT | False | DID Id to use | @@ -113,7 +113,7 @@ Usage: chia wallet nft mint [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -309,7 +309,7 @@ Usage: chia wallet nft set_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -346,7 +346,7 @@ Usage: chia wallet nft sign_message [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --nft_id | TEXT | True | NFT ID you want to use for signing | @@ -478,7 +478,7 @@ Usage: chia wallet nft list [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -577,7 +577,7 @@ Usage: chia wallet nft get_info [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -ni | --nft-coin-id | TEXT | True | Id of the NFT coin for which to show info | @@ -634,7 +634,7 @@ Usage: chia wallet nft transfer [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -712,7 +712,7 @@ Usage: chia wallet nft add_uri [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:--------------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :-------------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | @@ -779,7 +779,7 @@ Usage: chia wallet nft set_did [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | True | Id of the NFT wallet to use | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md index 13eb85ca86..f64afda0cd 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/offers.md @@ -37,7 +37,7 @@ Usage: `chia wallet make_offer [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:-------------:|:-----------------:|:-------:|:--------:|:-------------------------------------------------------------------------------------------------------- | +| :-----------: | :---------------: | :-----: | :------: | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -o | --offer | TEXT | True | A wallet id to offer and the amount to offer (formatted like wallet_id:amount) | @@ -59,7 +59,7 @@ Usage: `chia wallet take_offer [OPTIONS] PATH_OR_HEX` Options: | Short Command | Long Command | Type | Required | Description | -|:-------------:|:-----------------:|:-------:|:--------:|:-------------------------------------------------------------------------------------------------------- | +| :-----------: | :---------------: | :-----: | :------: | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -e | --examine-only | None | False | Print the summary of the offer file but do not take it | @@ -78,7 +78,7 @@ Usage: `chia wallet cancel_offer [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:-------------:|:-----------------:|:-------:|:--------:|:------------------------------------------------------------------------------------------------------------------------ | +| :-----------: | :---------------: | :-----: | :------: | :----------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -id | --id | TEXT | True | The offer ID that you wish to cancel | @@ -97,7 +97,7 @@ Usage: `chia wallet get_offers [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:-------------:|:----------------------:|:-------:|:--------:|:-------------------------------------------------------------------------------------------------------- | +| :-----------: | :--------------------: | :-----: | :------: | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -id | --id | TEXT | False | The ID of the offer that you wish to examine | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md index d50c1a8bf0..2c82ccf3c2 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/plotters.md @@ -19,28 +19,28 @@ Usage: chia plotters chiapos [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:--------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------- | -| -t | --tmp_dir | TEXT | True | Temporary directory 1 (where most of the plots temp data will be stored) | -| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | -| -k | --size | INTEGER | False | K value [Default: 32] | -| -m | --memo | TEXT | False | Memo variable | -| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | -| -b | --buffer | INTEGER | False | Size of the buffer, in MB [Default: 4608] | -| -u | --buckets | INTEGER | False | Number of buckets [Default: 64] | -| -s | --stripes | INTEGER | False | Stripe size [Default: 65536] | -| -r | --threads | INTEGER | False | Num threads [Default: 2] | -| -e | --nobitfield | None | False | Disable bitfield [Default: bitfield is enabled] | -| | --override-k | None | False | Force size smaller than 32 (only needed where `-k` is less than 32 [Default: disabled] | -| -a | --alt_fingerprint | INTEGER | False | Enter the alternative fingerprint of the key you want to use | -| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | -| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | -| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | -| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :------------------ | :------ | :------- | :---------------------------------------------------------------------------------------- | +| -t | --tmp_dir | TEXT | True | Temporary directory 1 (where most of the plots temp data will be stored) | +| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | +| -k | --size | INTEGER | False | K value [Default: 32] | +| -m | --memo | TEXT | False | Memo variable | +| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | +| -b | --buffer | INTEGER | False | Size of the buffer, in MB [Default: 4608] | +| -u | --buckets | INTEGER | False | Number of buckets [Default: 64] | +| -s | --stripes | INTEGER | False | Stripe size [Default: 65536] | +| -r | --threads | INTEGER | False | Num threads [Default: 2] | +| -e | --nobitfield | None | False | Disable bitfield [Default: bitfield is enabled] | +| | --override-k | None | False | Force size smaller than 32 (only needed where `-k` is less than 32 [Default: disabled] | +| -a | --alt_fingerprint | INTEGER | False | Enter the alternative fingerprint of the key you want to use | +| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | +| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | +| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | +| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -x | --exclude_final_dir | None | False | Skips adding [final dir] to harvester for farming [Default: copy to final dir is enabled] | -| -d | --final_dir | TEXT | True | Final directory after plot has been created | -| | --compress | INTEGER | False | Compression level [Default: 0 (not compressed)] | -| -h | --help | None | False | Show a help message and exit | +| -d | --final_dir | TEXT | True | Final directory after plot has been created | +| | --compress | INTEGER | False | Compression level [Default: 0 (not compressed)] | +| -h | --help | None | False | Show a help message and exit | ### `madmax` @@ -51,7 +51,7 @@ Usage: chia plotters madmax [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------- |:------- |:-------- |:---------------------------------------------------------------------------------------- | +| :------------ | :------------ | :------ | :------- | :--------------------------------------------------------------------------------------- | | -k | --size | INTEGER | False | K value [Default: 32] | | -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -r | --threads | INTEGER | False | Num threads [Default: 4] | @@ -84,26 +84,26 @@ Usage: chia plotters bladebit cudaplot [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | -| -r | --threads | INTEGER | False | Num threads [Default: 12] | -| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | -| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | -| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | -| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | -| -t | --tmp_dir | TEXT | False | Temporary directory 1 (where most of the plot's temp data will be stored) [Default: in memory] | -| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | -| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | -| -w | --warmstart | None | False | Set to enable warm start [Default: disabled] | -| | --nonuma | None | False | Set to disable numa [Default: enabled] | -| | --no-cpu-affinity | None | False | Set to disable assigning automatic thread affinity [Default: enabled] | -| -v | --verbose | None | False | Set to enable verbose output [Default: disabled] | -| -d | --final_dir | TEXT | True | Final directory after plot has been created | -| | --compress | INTEGER | False | Compression level, 0-9 are accepted [Default: 1] | -| | --device | INTEGER | False | The CUDA device index (typically 0 or 1), set if more than one GPU is installed [Default: 0] | -| | --disk-128 | None | False | Enable hybrid disk plotting, requires 128 GB of system RAM [Default: disabled] | -| | --disk-16\* | None | False | Enable hybrid disk plotting, requires at least 16 GB of system RAM [Default: disabled] **\*SEE WARNING BELOW** | -| -h | --help | None | False | Show a help message and exit | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------- | +| -r | --threads | INTEGER | False | Num threads [Default: 12] | +| -n | --count | INTEGER | False | Number of plots to create [Default: 1] | +| -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | +| -p | --pool-key | TEXT | False | Pool Public Key (48 bytes) [Default: use the key from the current wallet (self-pooling)] | +| -c | --contract | TEXT | False | Pool Contract Address (64 chars) [Default: none] | +| -t | --tmp_dir | TEXT | False | Temporary directory 1 (where most of the plot's temp data will be stored) [Default: in memory] | +| -2 | --tmp_dir2 | TEXT | False | Temporary directory 2 [Default: same as `tmp_dir`] | +| -i | --id | TEXT | False | Plot ID [Default: generate a random ID] | +| -w | --warmstart | None | False | Set to enable warm start [Default: disabled] | +| | --nonuma | None | False | Set to disable numa [Default: enabled] | +| | --no-cpu-affinity | None | False | Set to disable assigning automatic thread affinity [Default: enabled] | +| -v | --verbose | None | False | Set to enable verbose output [Default: disabled] | +| -d | --final_dir | TEXT | True | Final directory after plot has been created | +| | --compress | INTEGER | False | Compression level, 0-9 are accepted [Default: 1] | +| | --device | INTEGER | False | The CUDA device index (typically 0 or 1), set if more than one GPU is installed [Default: 0] | +| | --disk-128 | None | False | Enable hybrid disk plotting, requires 128 GB of system RAM [Default: disabled] | +| | --disk-16\* | None | False | Enable hybrid disk plotting, requires at least 16 GB of system RAM [Default: disabled] **\*SEE WARNING BELOW** | +| -h | --help | None | False | Show a help message and exit | :::warning warning @@ -136,7 +136,7 @@ Usage: chia plotters bladebit ramplot [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :--------------------------------------------------------------------------------------- | | -r | --threads | INTEGER | False | Num threads [Default: 12] | | -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | @@ -160,7 +160,7 @@ Usage: chia plotters bladebit diskplot [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------- | | -r | --threads | INTEGER | False | Num threads [Default: 12] | | -n | --count | INTEGER | False | Number of plots to create [Default: 1] | | -f | --farmerkey | TEXT | False | Farmer Public Key (48 bytes) [Default: use the key from the current wallet] | @@ -197,7 +197,7 @@ Usage: bladebit simulate [OPTIONS] \ Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---------- |:-------- |:-------------------------------------------------------------------------------------------------------------------- | +| :------------ | :----------- | :--------- | :------- | :------------------------------------------------------------------------------------------------------------------- | | -n | --iterations | INTEGER | False | The number of iterations to run [Default: 100] | | -p | --parallel | INTEGER | False | The number of instances to run in parallel [Default: 1] | | -l | --lookup | FLOAT | False | Maximum allowed time per proof lookup, in seconds [Default: 8.00] | @@ -226,14 +226,14 @@ Usage: drplotter plot [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:-------------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------- | -| -h | --help | None | False | Show a help message and exit | -| -f | --farmerkey | TEXT | True | Farmer Public Key (48 bytes, hex encoded) | -| -c | --contractkey | TEXT | True | Pool Contract Address (64 chars, hex encoded) | -| -d | --outputDirectory | TEXT | True | Final directory after plot has been created | -| | --compression | TEXT | False | Set compression mode. Choose between eco3x (68 bits per proof), or pro4x (49 bits per proof) [Default: eco3x] | -| -i | --gpu_id | INTEGER | False | GPU ID to use [Default: 0] | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :----------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------ | +| -h | --help | None | False | Show a help message and exit | +| -f | --farmerkey | TEXT | True | Farmer Public Key (48 bytes, hex encoded) | +| -c | --contractkey | TEXT | True | Pool Contract Address (64 chars, hex encoded) | +| -d | --outputDirectory | TEXT | True | Final directory after plot has been created | +| | --compression | TEXT | False | Set compression mode. Choose between eco3x (68 bits per proof), or pro4x (49 bits per proof) [Default: eco3x] | +| -i | --gpu_id | INTEGER | False | GPU ID to use [Default: 0] | | -n | --n_to_plot | INTEGER | False | Number of plots to create [Default: 0, fills directory] | | -L | --gpu_memory_limit | INTEGER | False | GPU memory limit in MB [Default: 0 (disabled)] | | | --min_gpu_ram | None | False | Use min gpu ram | @@ -247,7 +247,7 @@ Usage: drplotter verify [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:---------------------------- | +| :------------ | :----------- | :--- | :------- | :--------------------------- | | -h | --help | None | False | Show a help message and exit | | -f | --file | TEXT | False | File to read from | | -d | --directory | TEXT | False | Check all files in directory | @@ -263,7 +263,7 @@ Usage: drsolver [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:---------------- |:------- |:-------- |:---------------------------------------------------- | +| :------------ | :--------------- | :------ | :------- | :--------------------------------------------------- | | -h | --help | None | False | Show a help message and exit | | -g | --gpu | INTEGER | True | GPU ID to use for solving | | -v | --verbose | None | False | Verbose output | @@ -283,7 +283,7 @@ Usage: drserver [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:------- |:-------- |:---------------------------- | +| :------------ | :----------- | :------ | :------- | :--------------------------- | | -h | --help | None | False | Show a help message and exit | | -p | --port | INTEGER | True | Server port | | -t | --token | TEXT | True | Server token | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md index 9347dc37b0..21dfff1d95 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/simulator.md @@ -31,7 +31,7 @@ Usage: `chia dev sim create [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:---------------- |:------- |:-------- |:----------------------------------------------------------------------------- | +| :------------ | :--------------- | :------ | :------- | :---------------------------------------------------------------------------- | | -f | --fingerprint | INTEGER | False | Use your fingerprint to skip the key prompt | | -r | --reward_address | TEXT | False | Use this address instead of the default farming address | | -p | --plot-directory | TEXT | False | Set the directory in which to create/store plots (Default: 'simulator/plots') | @@ -305,7 +305,7 @@ Usage: `chia dev sim autofarm [OPTIONS] [on|off]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:---------------------------- | +| :------------ | :----------- | :--- | :------- | :--------------------------- | | -h | --help | None | False | Show a help message and exit | Auto farming is enabled by default. The examples will show you how to disable/enable it. @@ -355,7 +355,7 @@ Usage: `chia dev sim farm [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------- | | -b | --blocks | INTEGER | False | Number of blocks to create (Default: 1) | | -n | --non-transaction | None | False | Enable to allow non-transaction blocks (Default: disabled) | | -a | --target-address | TEXT | False | Block reward address. If not specified, the default address will be used | @@ -490,7 +490,7 @@ Usage: `chia dev sim revert [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:---------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :--------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -b | --blocks | INTEGER | False | Number of blocks to go back (Default: 1) | | -n | --new_blocks | INTEGER | False | Number of new blocks to add during a reorg (Default: 1) | | -r | --reset | None | False | Enable to revert all transactions to the genesis block (Default: disabled) | @@ -563,7 +563,7 @@ Usage: `chia dev sim start [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------ | +| :------------ | :----------- | :--- | :------- | :----------------------------------------------------- | | -r | --restart | None | False | Enable to restart running services (Default: disabled) | | -w | --wallet | None | False | Enable to start wallet (Default: disabled) | | -h | --help | None | False | Show a help message and exit | @@ -619,7 +619,7 @@ Usage: `chia dev sim status [OPTIONS]` Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------- | | -f | --fingerprint | INTEGER | False | Get detailed information on this fingerprint. | | -k | --show_key | None | False | Enable to show detailed key information, including seed phrase (Default: disabled) | | -c | --show_coins | None | False | Enable to show all unspent coins (Default: disabled). When enabled, this does not show reward coins unless used in conjunction with `-i` | @@ -841,7 +841,7 @@ Usage: `chia dev sim stop [OPTIONS]` Options: Stop running services | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:--------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :-------------------------------------------- | | -d | --daemon | None | False | Enable to stop the daemon (Default: disabled) | | -w | --wallet | None | False | Enable to stop the wallet (Default: disabled) | | -h | --help | None | False | Show a help message and exit | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md index 4bdd6b69da..7b070d0932 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/vcs.md @@ -20,10 +20,10 @@ Usage: chia wallet vcs add_proof_reveal [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -p | --proof | TEXT | True\* | A flag to add as a proof | +| -p | --proof | TEXT | True\* | A flag to add as a proof | | -r | --root-only | None | False | If this flag is set, do not add the proofs to the DB, just output the root from the specified proofs [Default: not set] | | -h | --help | None | False | Show a help message and exit | @@ -72,7 +72,7 @@ Usage: chia wallet vcs get [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | | -s | --start | INTEGER | False | The index to start the list at [default: 0] | @@ -109,7 +109,7 @@ Usage: chia wallet vcs get_proofs_for_root [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | | -r | --proof-hash | TEXT | True | The root to search for | @@ -147,7 +147,7 @@ Usage: chia wallet vcs mint [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use as the issuing wallet | | -d | --did | TEXT | True | The DID of the VC's proof provider. Must be owned by the issuing wallet Must be owned by the issuing wallet | @@ -223,11 +223,11 @@ Usage: chia wallet vcs revoke [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :--------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | -| -p | --parent-coin-id | TEXT | True\* | The ID of the parent coin of the VC (\*optional if VC ID is used) | -| -l | --vc-id TEXT | TEXT | True\* | The launcher ID of the VC to revoke (must be tracked by wallet) (\*optional if Parent ID is used) | +| -p | --parent-coin-id | TEXT | True\* | The ID of the parent coin of the VC (\*optional if VC ID is used) | +| -l | --vc-id TEXT | TEXT | True\* | The launcher ID of the VC to revoke (must be tracked by wallet) (\*optional if Parent ID is used) | | -m | --fee | TEXT | False | Blockchain fee for revocation transaction, in XCH | | | --reuse-puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from (ignored if `--generate-new-puzhash` is also specified) [Default: generate new puzzle hash] | | | --generate-new-puzhash | None | False | If this flag is set, then send the VC to a new puzzle hash. This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set This is the default behavior, and setting this flag will override the `--reuse-puzhash` flag if it is also set | @@ -289,7 +289,7 @@ Usage: chia wallet vcs update_proofs [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :--------------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the rpc_port under wallet in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which key to use | | -l | --vc-id | TEXT | True | The launcher ID of the VC whose proofs should be updated | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md index a39cbfd6b3..e0649ea275 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/cli-reference/wallet.md @@ -24,7 +24,7 @@ Usage: chia wallet add_token [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -id | --asset-id | TEXT | True | The Asset ID of the coin you wish to add/rename (the treehash of the TAIL program) | | -n | --token-name | TEXT | False | The name you wish to designate to the token | @@ -63,7 +63,7 @@ Usage: chia wallet coins list [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------------ |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------- | +| :------------ | :----------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------- | | -p | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | Id of the wallet to use [default: 1] | @@ -309,7 +309,7 @@ Usage: chia wallet coins combine [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- | | -p | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -801,7 +801,7 @@ Usage: chia wallet coins split [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -p | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -913,7 +913,7 @@ Usage: chia wallet delete_unconfirmed_transactions [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1062,7 +1062,7 @@ Usage: chia wallet delete_unconfirmed_transactions [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1094,7 +1094,7 @@ Usage: chia wallet get_address [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | @@ -1130,7 +1130,7 @@ Usage: chia wallet get_derivation_index [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -h | --help | None | False | Show a help message and exit | @@ -1161,7 +1161,7 @@ Usage: chia wallet get_transaction [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i, | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -1199,7 +1199,7 @@ Usage: chia wallet get_transactions [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------- | +| :------------ | :------------------ | :------ | :------- | :---------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -1209,7 +1209,7 @@ Options: | | --paginate | None | False | Prompt for each page of data. Defaults to enabled for interactive consoles, otherwise defaults to disabled | | | --no-paginate | None | False | Do not prompt for each page of data. Defaults to disabled for interactive consoles, otherwise defaults to enabled | | | --sort-by-height | None | False | Sort transactions by height [default: disabled] | -| | --sort-by-relevance | None | False | Sort transactions by \{confirmed \| height \| time\} [default: disabled] | +| | --sort-by-relevance | None | False | Sort transactions by \{confirmed \| height \| time\} [default: disabled] | | | --reverse | None | False | Reverse the transaction ordering [default: disabled] | | | --clawback | None | False | Only show clawback transactions [default: disabled] | | -h | --help | None | False | Show a help message and exit | @@ -1376,7 +1376,7 @@ Usage: chia wallet notifications delete [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | TEXT | False | A specific notification ID to delete | @@ -1411,7 +1411,7 @@ Usage: chia wallet notifications get [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | TEXT | False | The specific notification ID to show | @@ -1453,7 +1453,7 @@ Usage: chia wallet notifications send [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -t | --to-address | TEXT | True | The address to send the notification to | @@ -1490,7 +1490,7 @@ Usage: chia wallet send [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :---------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --id | INTEGER | False | ID of the wallet to use [default: 1] | @@ -1590,12 +1590,12 @@ Usage: chia wallet show [OPTIONS] Options: -| Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | -| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | +| Short Command | Long Command | Type | Required | Description | +| :------------ | :---------------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | +| -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -w | --wallet_type | TEXT | False | Choose a specific wallet type to return, choose from the following: [standard_wallet \| atomic_swap \| authorized_payee \| multi_sig \| custody \| cat \| recoverable \| decentralized_id \| pooling_wallet \| nft \| data_layer \| data_layer_offer] | -| -h | --help | None | False | Show a help message and exit | +| -h | --help | None | False | Show a help message and exit |
Example @@ -1654,7 +1654,7 @@ Usage: chia wallet sign_message [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -a | --address | TEXT | True | The address you want to use for signing | @@ -1689,7 +1689,7 @@ Usage: chia wallet update_derivation_index [OPTIONS] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:----------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------ | +| :------------ | :---------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------- | | -wp | --wallet-rpc-port | INTEGER | False | Set the port where the Wallet is hosting the RPC interface. See the `rpc_port` under `wallet` in config.yaml | | -f | --fingerprint | INTEGER | False | Set the fingerprint to specify which wallet to use | | -i | --index | INTEGER | True | Index to set. Must be greater than the current derivation index | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md index 95d23c163c..744f65daca 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/clvm-vs-evm.md @@ -12,17 +12,17 @@ We'll start with a brief description of CLVM. For details on the inner workings ## Comparison -| Design decision | EVM (Solidity) | CLVM (Chialisp) | -| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| The blockchain contains... | Smart contracts (compiled programs) as well as accounts. | The root hash of a binary tree, not source code. | -| Money | Smart contracts _contain_ money. | Standard Chia coins don't _contain_ money. They _are_ money. That said, more complex functionality is possible, allowing coins to contain state, such as money. | -| Determinism | Less deterministic because multiple people can execute code within the same contract. Depending on the order of execution, the result won't always be the same. | More deterministic because coins can only be spent once. However, it's possible to have a coin that multiple people can spend, which would reduce determinism. | -| Centralization | Multiple people interact with the same contract. Centralized by design. | Only the owner interacts with a smart coin. Decentralized by design. | -| Sandboxing | No sandboxing. If a contract is hacked, all users can lose their money. | Strong sandboxing. Spending is the only action allowed on an unspent coin, and only by the owner(s). If a coin is hacked, only that coin's owner(s) lose(s) their money. | +| Design decision | EVM (Solidity) | CLVM (Chialisp) | +| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| The blockchain contains... | Smart contracts (compiled programs) as well as accounts. | The root hash of a binary tree, not source code. | +| Money | Smart contracts _contain_ money. | Standard Chia coins don't _contain_ money. They _are_ money. That said, more complex functionality is possible, allowing coins to contain state, such as money. | +| Determinism | Less deterministic because multiple people can execute code within the same contract. Depending on the order of execution, the result won't always be the same. | More deterministic because coins can only be spent once. However, it's possible to have a coin that multiple people can spend, which would reduce determinism. | +| Centralization | Multiple people interact with the same contract. Centralized by design. | Only the owner interacts with a smart coin. Decentralized by design. | +| Sandboxing | No sandboxing. If a contract is hacked, all users can lose their money. | Strong sandboxing. Spending is the only action allowed on an unspent coin, and only by the owner(s). If a coin is hacked, only that coin's owner(s) lose(s) their money. | | Composability | Composition is supported, so it is possible to set rules temporarily governing how money may be spent. However, if money is moved outside of the contract, it will follow different rules.

(Note that it is possible to create a contract that “traps” ETH inside of it by only allowing money to be sent from the contract to specific types of addresses. However, by definition this limits the functionality of that money to whatever is contained within the contract.) | Composition is handled through inner puzzles. A puzzle's creator could say, “As long as these rules are followed, an inner puzzle can add any functionality.” Thus, it is possible to set rules that are intrinsic to the money itself, which must be followed _forever_. | -| MEV | Changing transaction order is both profitable and common. MEV is high. | Transactions all occur simultaneously in a block. MEV is low. | -| Reentrancy | Contracts can call functions on other contracts. Withdrawals can happen multiple times. Reentrancy is possible and must be carefully guarded against. | Coins interact with each other through announcements. They cannot call functions on other coins. Spends are atomic. Reentrancy is not possible. | -| Auditability/Security | Weak. Multiple points of failure. Numerous hacks prove this. | Strong. If an attacker changes a coin's puzzle, the hash also changes. The attacker is thus attempting to spend a coin that does not exist. The attacker can modify the solution, but the programmer can counter this by using assertions, which will make any such modifications fail. | +| MEV | Changing transaction order is both profitable and common. MEV is high. | Transactions all occur simultaneously in a block. MEV is low. | +| Reentrancy | Contracts can call functions on other contracts. Withdrawals can happen multiple times. Reentrancy is possible and must be carefully guarded against. | Coins interact with each other through announcements. They cannot call functions on other coins. Spends are atomic. Reentrancy is not possible. | +| Auditability/Security | Weak. Multiple points of failure. Numerous hacks prove this. | Strong. If an attacker changes a coin's puzzle, the hash also changes. The attacker is thus attempting to spend a coin that does not exist. The attacker can modify the solution, but the programmer can counter this by using assertions, which will make any such modifications fail. | --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md index d24b24c341..c920ab516a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/coin-set-model/costs.md @@ -148,20 +148,20 @@ The [minimum effective](/mempool/#fee-required-for-inclusion) fee represents 5 x Please note that the costs and fees listed are for vanilla versions of these transactions, they can vary based on the number of input and output coins needed so consider these the bare minimum. Transactions with a '\*' are listed with a fee of 3 x the minimum effective fee. This is to ensure the fees are more realistic for how coins are distributed in users wallets but note that vanilla versions of these would be 1/3 that which is listed. ::: -| Transaction Type | clvm Cost | Minimum Effective Fee | -| --------------------------------- | ------------- | ----------------------------------- | -| **Full Block (with 50% cap)** | 5,500,000,000 | 27,500,000,000 mojo (0.0275 xch) | +| Transaction Type | clvm Cost | Minimum Effective Fee | +| --------------------------------- | ------------- | --------------------------------- | +| **Full Block (with 50% cap)** | 5,500,000,000 | 27,500,000,000 mojo (0.0275 xch) | | **Standard Transaction** | 6,000,000 | 90,000,000 mojo (0.00009 xch) \* | -| **PlotNFT Creation** | 18,000,000 | 90,000,000 mojo (0.00009 xch) | -| **Minting NFT with DID** | 123,000,000 | 615,000,000 mojo (0.000615 xch) | -| **Minting NFT without DID** | 53,000,000 | 265,000,000 mojo (0.000265 xch) | -| **Adding URI to NFT with DID** | 71,000,000 | 355,000,000 mojo (0.000355 xch) | -| **Adding URI to NFT without DID** | 41,000,000 | 205,000,000 mojo (0.000205 xch) | -| **Transfer NFT with DID** | 67,000,000 | 335,000,000 mojo (0.000335 xch) | -| **Assign DID to NFT** | 107,000,000 | 535,000,000 mojo (0.000535 xch) | +| **PlotNFT Creation** | 18,000,000 | 90,000,000 mojo (0.00009 xch) | +| **Minting NFT with DID** | 123,000,000 | 615,000,000 mojo (0.000615 xch) | +| **Minting NFT without DID** | 53,000,000 | 265,000,000 mojo (0.000265 xch) | +| **Adding URI to NFT with DID** | 71,000,000 | 355,000,000 mojo (0.000355 xch) | +| **Adding URI to NFT without DID** | 41,000,000 | 205,000,000 mojo (0.000205 xch) | +| **Transfer NFT with DID** | 67,000,000 | 335,000,000 mojo (0.000335 xch) | +| **Assign DID to NFT** | 107,000,000 | 535,000,000 mojo (0.000535 xch) | | **Send Clawback Transaction** | 10,000,000 | 150,000,000 mojo (0.00015 xch) \* | -| **Claim Clawback Transaction** | 1,400,000 | 7,000,000 mojo (.000007 xch) | -| **Clawback Clawback Transaction** | 15,600,000 | 75,800,000 mojo (.0000758 xch) | -| **Combine 500 Farming Rewards** | 3,100,000,000 | 15,500,000,000 mojo (.0155 xch) | -| **Split 1 Coin into 2** | 11,000,000 | 55,000,000 mojo (.000055 xch) | +| **Claim Clawback Transaction** | 1,400,000 | 7,000,000 mojo (.000007 xch) | +| **Clawback Clawback Transaction** | 15,600,000 | 75,800,000 mojo (.0000758 xch) | +| **Combine 500 Farming Rewards** | 3,100,000,000 | 15,500,000,000 mojo (.0155 xch) | +| **Split 1 Coin into 2** | 11,000,000 | 55,000,000 mojo (.000055 xch) | | **Cat Transaction** | 37,000,000 | 555,000,000 mojo (.000555 xch) \* | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md index a163222fa7..1252d5259f 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/attacks-and-countermeasures.md @@ -79,7 +79,7 @@ Finally, the formula to calculate the minimum netspace percentage required for t The following table shows the minimum required proportion of the total netspace an attacker must have in order to succeed in a majority attack. This table is valid for attacks lasting any amount of time, though sometimes it's overly conservative for attacks lasting more than one epoch. It uses fixed values for the first two columns. | Number of Timelords | VA (relative to VH) | DD | SA | Percent of netspace required | Comment | -|:-------------------:|:-------------------:|:-------:|:-----:|:----------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :-----------------: | :-----------------: | :-----: | :---: | :--------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 0 | N/A | 1 | ∞ | N/A | Without a timelord, the attack is not possible. | | 1 | 0.5 | 1 | 2 | 66.7% | With a 0.5x timelord, the attacker must control twice as much space as the rest of the network combined. | | ∞ | 0.5 | 1.34313 | 1.489 | 59.8% | With infinite 0.5x timelords, the attacker gains a double-dip advantage, so less space is required versus having a single timelord of the same speed. | @@ -91,7 +91,7 @@ The following table shows the minimum required proportion of the total netspace For attacks lasting longer than one epoch, `DD` will not exceed 1.34313. In such an attack, the final row from the preceding table will change to the following: | Number of Timelords | VA (relative to VH) | DD | SA | Percent of netspace required | Comment | -|:-------------------:|:-------------------:|:-------:|:-----:|:----------------------------:|:-------------------------------------------------------------------------------- | +| :-----------------: | :-----------------: | :-----: | :---: | :--------------------------: | :------------------------------------------------------------------------------- | | ∞ | 2 | 1.34313 | 0.372 | 27.1% | If the attack longer than one epoch, the double-dip advantage will be minimized. | Note that if we continue to increase `VA`, `DD` will always remain at 1.4678 for the first table, and 1.34313 for the second table. The percent of netspace required will decrease linearly. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md index 44cdb78587..0105ad3c0a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/forks.md @@ -5,12 +5,12 @@ slug: /consensus-forks The following table is a comprehensive list of all forks (planned and activated) on Chia's blockchain. It was last updated on 2023-09-10. It was last updated on 2023-09-10. -| Activation Block | Activation Date | Type | Build | Status | Description | -|:---------------- |:--------------- |:---- |:----- |:----------------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `2 300 000` | 2022-07-22 | Soft | 1.3.0 | Activated | [Disallow negative division](https://www.chia.net/2022/03/04/divided-we-fork/) | -| `3 630 000` | 2023-05-07 | Soft | 1.7.0 | Activated | [Restrict `AGG_SIG_UNSAFE` message](https://github.com/Chia-Network/post-mortem/blob/main/2023-05/2023-05-08-AGG_SIG_UNSAFE-can-mimic-AGG_SIG_ME-condition.md) | -| `3 886 635` | 2023-07-01 | Soft | 1.8.0 | Activated | [CHIP-14](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0014.md) -- `ASSERT_BEFORE_*` conditions | -| `4 510 000` | 2023-11-12 | Soft | 2.0.0 | Activated | [CHIP-11](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md) -- BLS/SECP CLVM Operators | -| `5 496 000` | 2024-06-13 | Hard | 2.1.0 | Activated | [CHIP-12](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0012.md) -- Decrease plot filter | +| Activation Block | Activation Date | Type | Build | Status | Description | +| :--------------- | :-------------- | :--- | :---- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `2 300 000` | 2022-07-22 | Soft | 1.3.0 | Activated | [Disallow negative division](https://www.chia.net/2022/03/04/divided-we-fork/) | +| `3 630 000` | 2023-05-07 | Soft | 1.7.0 | Activated | [Restrict `AGG_SIG_UNSAFE` message](https://github.com/Chia-Network/post-mortem/blob/main/2023-05/2023-05-08-AGG_SIG_UNSAFE-can-mimic-AGG_SIG_ME-condition.md) | +| `3 886 635` | 2023-07-01 | Soft | 1.8.0 | Activated | [CHIP-14](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0014.md) -- `ASSERT_BEFORE_*` conditions | +| `4 510 000` | 2023-11-12 | Soft | 2.0.0 | Activated | [CHIP-11](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0011.md) -- BLS/SECP CLVM Operators | +| `5 496 000` | 2024-06-13 | Hard | 2.1.0 | Activated | [CHIP-12](https://github.com/Chia-Network/chips/blob/main/CHIPs/chip-0012.md) -- Decrease plot filter | | `5 716 000` | 2024-07 | Soft | 2.3.0 | Released,
Not Activated | [CHIP-25](https://github.com/Chia-Network/chips/pull/98) -- Chialisp Message Conditions | | `5 940 000` | 2024-09 | Soft | 2.4.0 | Released,
Not Activated | Disallow infinity G1 points | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md index 7c603d5b39..29b3338426 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/consensus/signage-and-infusion-points.md @@ -38,7 +38,7 @@ For both of our [previous example](/consensus-challenges), as well as the next e - _sub-slot_iterations = 100,000,000_ - _sp_interval_iterations = `sub-slot_iterations` / 64 = 1,562,500_ -The farmer computes the **required_iterations** for each proof of space. If the required_iterations < sp_interval_iterations, the proof of space is eligible for inclusion into the blockchain. At this point, the farmer fetches the entire proof of space from disk (which requires 64 disk seeks, or 640 ms on a slow HDD), creates an unfinished block, and broadcasts it to the network. If the _required_iterations < sp_interval_iterations_, the proof of space is eligible for inclusion into the blockchain. At this point, the farmer fetches the entire proof of space from disk (which requires 64 disk seeks, or 640 ms on a slow HDD), creates an unfinished block, and broadcasts it to the network. +The farmer computes the **required_iterations** for each proof of space. If the required*iterations < sp_interval_iterations, the proof of space is eligible for inclusion into the blockchain. At this point, the farmer fetches the entire proof of space from disk (which requires 64 disk seeks, or 640 ms on a slow HDD), creates an unfinished block, and broadcasts it to the network. If the \_required_iterations < sp_interval_iterations*, the proof of space is eligible for inclusion into the blockchain. At this point, the farmer fetches the entire proof of space from disk (which requires 64 disk seeks, or 640 ms on a slow HDD), creates an unfinished block, and broadcasts it to the network. :::info For the vast majority of eligible plots, _required_iterations_ will be far too high, since on average 32 will qualify for the whole network for each 10-minute sub-slot. This is a random process so it's possible (though unlikely) for a large number of proofs to qualify. Any plot that does meet the _required_iterations_ for a signage point will qualify as there is no rivalry between winning plots. @@ -93,9 +93,9 @@ Recall that in this example, - _sub-slot_iterations = 100,000,000_ - _= (signage \* point \* sp \* interval_iterations) + (3 \* sp_interval_iterations) + required_iterations_ -For each of the 64 signage points, as they are released to the network every 9.375 seconds, or every 1.5625M iterations, the farmer computes the plot filter and sees how many plots pass. For each passing plot, the farmer calculates required_iterations. For each passing plot, the farmer calculates _required_iterations_. +For each of the 64 signage points, as they are released to the network every 9.375 seconds, or every 1.5625M iterations, the farmer computes the plot filter and sees how many plots pass. For each passing plot, the farmer calculates required*iterations. For each passing plot, the farmer calculates \_required_iterations*. -Let's say the farmer calculates required_iterations < 1.5625M once in the sub-slot. (We'll assume the exact required_iterations = 0.7828M in this instance.) Figure 5 shows this happening at the 20th signage point. (We'll assume the exact _required_iterations = 782,800_ in this instance.) Figure 5 shows this happening at the 20th signage point. +Let's say the farmer calculates required*iterations < 1.5625M once in the sub-slot. (We'll assume the exact required_iterations = 0.7828M in this instance.) Figure 5 shows this happening at the 20th signage point. (We'll assume the exact \_required_iterations = 782,800* in this instance.) Figure 5 shows this happening at the 20th signage point. infusion_iterations is then computed as: @@ -125,14 +125,14 @@ This begs the question: why not use even more signage points in the consensus? T **Quality string**: A small part of the proof of space, 2 _x values_ out of the total 64 _x values_, which can be retrieved efficiently from disk, and which values_to_fetch is determined by the signage point. -**sp_quality_string**: A hash of the quality string concatenated with the challenge chain's signage point. This hash is what ultimately decides the "luck" of a certain proof, using the size of required_iterations. This hash is what ultimately decides the "luck" of a certain proof, using the size of _required_iterations_ +**sp_quality_string**: A hash of the quality string concatenated with the challenge chain's signage point. This hash is what ultimately decides the "luck" of a certain proof, using the size of required*iterations. This hash is what ultimately decides the "luck" of a certain proof, using the size of \_required_iterations* **sp_interval_iterations**: Defined as floor(sub-slot_iterations / 64). **Signage points**: 64 intermediary points in time within a sub-slot in both the challenge and reward chains, for which VDFs are periodically released. At each signage point, a VDF output is created and broadcast through the network. The first signage point in the sub-slot is the challenge itself. Each block has a signage point such that the proof of space in the block must be eligible for that signage point. -**required_iterations**: A number computed using the quality string, used to choose proofs of space which are eligible to make blocks. The vast majority of proofs of space will have required_iterations which are too high, and thus not eligible for inclusion into the chain. This number is used to compute the infusion point. The vast majority of proofs of space will have _required_iterations_ which are too high, and thus not eligible for inclusion into the chain. This number is used to compute the infusion point. +**required_iterations**: A number computed using the quality string, used to choose proofs of space which are eligible to make blocks. The vast majority of proofs of space will have required*iterations which are too high, and thus not eligible for inclusion into the chain. This number is used to compute the infusion point. The vast majority of proofs of space will have \_required_iterations* which are too high, and thus not eligible for inclusion into the chain. This number is used to compute the infusion point. -**Infusion point**: The point in time at infusion_iterations from the challenge point, for a proof of space with a certain challenge and infusion_iterations. At this point, the farmer's block gets infused into the reward chain VDF. The infusion point of a block is always between 3 and 4 signage points after the signage point of that block. Computed as signage_point_iterations + 3 \* sp_interval_iterations + required_iterations. At this point, the farmer's block gets infused into the reward chain VDF. The infusion point of a block is always between 3 and 4 signage points after the signage point of that block. Computed as _signage_point_iterations + 3 \* sp_interval_iterations + required_iterations_. +**Infusion point**: The point in time at infusion*iterations from the challenge point, for a proof of space with a certain challenge and infusion_iterations. At this point, the farmer's block gets infused into the reward chain VDF. The infusion point of a block is always between 3 and 4 signage points after the signage point of that block. Computed as signage_point_iterations + 3 \* sp_interval_iterations + required_iterations. At this point, the farmer's block gets infused into the reward chain VDF. The infusion point of a block is always between 3 and 4 signage points after the signage point of that block. Computed as \_signage_point_iterations + 3 \* sp_interval_iterations + required_iterations*. The delay between the signage point and infusion point has many benefits, including defense against orphaning and selfish farming, decreased forks, and no VDF pauses. This delay of around 28 seconds is given so that farmers have enough time to sign without delaying the slot VDF. Well-behaving farmers sign only one signage point with each proof of space, meaning that attackers cannot easily reorg the chain. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md index 425c3ad176..bba5e90650 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/farming-basics.md @@ -35,7 +35,7 @@ Every three years, there is a scheduled halving of the block reward. Every three 以下是完整的区块奖励计划： -| 年份 | 区块奖励 | XCH / 10 mins | +| 年份 | 区块奖励 | XCH / 10 mins | | ----- | --------- | ------------- | | 1-3 | 2.0 XCH | 64 | | 4-6 | 1.0 XCH | 32 | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md index 4eaff1758b..b3697c8046 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/farming/pool-farming.md @@ -59,7 +59,7 @@ chia plotnft create -s local chia plotnft create -s pool -u https://bar.examplepool.org ``` -请注意，即便选择的是选项1，以后仍然可以加入联合耕种池，并且可以随时切换到其它池。 如果决定加入一个联合耕种池，请输入网址 (必须以 _https://_开头)，然后查看描述。 如果同意, 则开始创建联合耕种农田, 并等待它被确认 (只点击一次)。 这可能需要几分钟的时间才能得到确认，然后出现在“联合耕种”选项卡中。 您只需要 1 个联合耕种农田。 +请注意，即便选择的是选项1，以后仍然可以加入联合耕种池，并且可以随时切换到其它池。 如果决定加入一个联合耕种池，请输入网址 (必须以 *https://*开头)，然后查看描述。 如果同意, 则开始创建联合耕种农田, 并等待它被确认 (只点击一次)。 这可能需要几分钟的时间才能得到确认，然后出现在“联合耕种”选项卡中。 您只需要 1 个联合耕种农田。 #### 使用图形用户界面（GUI） diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md index 8aa6e48fca..14e9629470 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/wallet-guide.md @@ -695,7 +695,6 @@ This is viewable in the offer's details: -
While the Offer is pending, the Maker attempts to send 0.1 XCH to another address. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md index 16210e7f7e..181b63c4e5 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/constants-variables-notation.md @@ -8,29 +8,29 @@ slug: /constants-variables-notation ## 0.1 重要常数 -| 常数 | Description | -| -------- | --------------------------- | -| 10分钟 | 目标 **子时隙（sub-slot）的间隔时长** | -| 32个区块 | 每个目标 **子时隙的区块数量** | -| 16/64个区块 | 每个时隙的最小/最大区块数量 | -| 4608个区块 | 平均每个**纪元（epoch）的区块**数量 | +| 常数 | Description | +| ----------- | ----------------------------------------- | +| 10分钟 | 目标 **子时隙（sub-slot）的间隔时长** | +| 32个区块 | 每个目标 **子时隙的区块数量** | +| 16/64个区块 | 每个时隙的最小/最大区块数量 | +| 4608个区块 | 平均每个**纪元（epoch）的区块**数量 | | 384个区块 | 平均每个**子纪元（sub-epoch）的区块**数量 | -| 64个签名点 | 每个**子时隙的签名点**数量 | +| 64个签名点 | 每个**子时隙的签名点**数量 | 由上可得以下结论： -| 隐含的常数 | Description | -| ------ | ----------------------------------------------------------------------------------------------------------------------------- | -| 1天 | **一个纪元的时长**为 $$10 {\ \sf min}\cdot\frac{4608{\ \sf blocks}}{32\ \sf blocks}=1440{\ \sf min}\quad (=1{ \sf day})$$ | -| 2小时 | **目标**子纪元的时长**** | -| 18.75秒 | 平均**完成一个区块的时长**为 $\frac{10{\sf\ min}}{32}=18.75 {\sf\ sec}$ | -| 9.375秒 | **签名点之间的时长**为 $\frac{600}{64}=9.375 {\sf\ sec}$ | +| 隐含的常数 | Description | +| ---------- | ------------------------------------------------------------------------------------------------------------------------- | +| 1天 | **一个纪元的时长**为 $$10 {\ \sf min}\cdot\frac{4608{\ \sf blocks}}{32\ \sf blocks}=1440{\ \sf min}\quad (=1{ \sf day})$$ | +| 2小时 | **目标**子纪元的时长\*\*\*\* | +| 18.75秒 | 平均**完成一个区块的时长**为 $\frac{10{\sf\ min}}{32}=18.75 {\sf\ sec}$ | +| 9.375秒 | **签名点之间的时长**为 $\frac{600}{64}=9.375 {\sf\ sec}$ | ## 0.2 重要变量 -| 变量 | Description | -| -------------------- | ------------------------------------------- | -| $D\in{\mathbb N}$ | 难度参数。 每个纪元重新校准一次，以满足每个时隙（slot）32个区块的目标 | +| 变量 | Description | +| ------------------ | -------------------------------------------------------------------------------- | +| $D\in{\mathbb N}$ | 难度参数。 每个纪元重新校准一次，以满足每个时隙（slot）32个区块的目标 | | $T\in {\mathbb N}$ | 时间参数（子时隙的VDF步数）。 每个纪元重新校准一次，以满足每个子时隙10分钟的目标 | ## 0.3 提示 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md index 19af568982..7390890b37 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-introduction.md @@ -52,7 +52,7 @@ This assumption comes at a prize: there's a $1.47$ factor by which the adversari The bound in eq.(1) is not tight in the sense that we don't have an attack that works if we replace "$>$" with "$<$". We have an attack assuming giving the adversary a slightly lower boosting factor of $1.34$ -$$ \textrm{double spending in {\sf Chia}\ possible if : }space_h\cdot vdf_h < space_a \cdot vdf_a \cdot 1.34 $$ +$$ \textrm{double spending in {\sf Chia}\ possible if : }space_h\cdot vdf_h < space_a \cdot vdf_a \cdot 1.34 $$
eq.(3)
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md index 8ba22edd52..46313aac7f 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/green-paper-references.md @@ -9,8 +9,8 @@ slug: /green-paper-references | Identifier | Publication | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | AAC+17 | Hamza Abusalah, Joël Alwen, Bram Cohen, Danylo Khilko, Krzysztof Pietrzak, and Leonid Reyzin. Beyond Hellman’s time-memory trade-offs with applications to proofs of space. In Tsuyoshi Takagi and Thomas Peyrin, editors, _Advances in Cryptology - ASI- ACRYPT 2017 - 23rd International Conference on the Theory and Applications of Cryptology and Information Security, Hong Kong, China, December 3-7, 2017, Proceedings, Part II_, volume 10625 of _Lecture Notes in Computer Science_, pages 357–379. Springer, 2017. | -| BBBF18 | Dan Boneh, Joseph Bonneau, Benedikt Bu ̈nz, and Ben Fisch. Verifiable delay functions. In Hovav Shacham and Alexandra Boldyreva, editors, _Advances in Cryptology - CRYPTO 2018 - 38th Annual International Cryptology Conference, Santa Barbara, CA, USA, August 19-23, 2018, Proceedings, Part I, volume 10991 of Lecture Notes in Computer Science_, pages 757–788. Springer, 2018. | -| BBF18 | Dan Boneh, Benedikt Bu ̈nz, and Ben Fisch. A survey of two verifi- able delay functions. _IACR Cryptol. ePrint Arch._, page 712, 2018. | +| BBBF18 | Dan Boneh, Joseph Bonneau, Benedikt Bu ̈nz, and Ben Fisch. Verifiable delay functions. In Hovav Shacham and Alexandra Boldyreva, editors, _Advances in Cryptology - CRYPTO 2018 - 38th Annual International Cryptology Conference, Santa Barbara, CA, USA, August 19-23, 2018, Proceedings, Part I, volume 10991 of Lecture Notes in Computer Science_, pages 757–788. Springer, 2018. | +| BBF18 | Dan Boneh, Benedikt Bu ̈nz, and Ben Fisch. A survey of two verifi- able delay functions. _IACR Cryptol. ePrint Arch._, page 712, 2018. | | BDK+19 | Vivek Bagaria, Amir Dembo, Sreeram Kannan, Sewoong Oh, David Tse, Pramod Viswanath, Xuechao Wang, and Ofer Zeitouni. Proof- of-stake longest chain protocols: Security vs predictability. 2019. | | BGK+18 | Christian Badertscher, Peter Gazi, Aggelos Kiayias, Alexander Russell, and Vassilis Zikas. Ouroboros genesis: Composable proof-of-stake blockchains with dynamic availability. In David Lie, Mohammad Mannan, Michael Backes, and XiaoFeng Wang, editors, _Proceedings of the 2018 ACM SIGSAC Conference on Computer and Communications Security, CCS 2018, Toronto, ON, Canada, October 15-19, 2018_, pages 913–930. ACM, 2018. | | BNPW19 | Jonah Brown-Cohen, Arvind Narayanan, Alexandros Psomas, and S. Matthew Weinberg. Formal barriers to longest-chain proof-of-stake protocols. In Anna Karlin, Nicole Immorlica, and Ramesh Johari, editors, _Proceedings of the 2019 ACM Conference on Economics and Computation, EC 2019, Phoenix, AZ, USA, June 24-28, 2019_, pages 459–473. ACM, 2019. | @@ -21,7 +21,7 @@ slug: /green-paper-references | DKT21 | Soubhik Deb, Sreeram Kannan, and David Tse. Posat: Proof-of-work availability and unpredictability, without the work. In Nikita Borisov and Claudia Diaz, editors, _Financial Cryptography and Data Security - 25th International Conference, FC 2021, Virtual Event, March 1-5, 2021, Revised Selected Papers, Part II, volume 12675 of Lecture Notes in Computer Science_, pages 104–128. Springer, 2021. | | DW13 | Christian Decker and Roger Wattenhofer. Information propagation in the bitcoin network. In _13th IEEE International Conference on Peer-to-Peer Computing, IEEE P2P 2013, Trento, Italy, September 9-11, 2013_, Proceedings, pages 1–10. IEEE, 2013. | | EFKP20 | Naomi Ephraim, Cody Freitag, Ilan Komargodski, and Rafael Pass. Continuous verifiable delay functions. Naomi Ephraim, Cody Freitag, Ilan Komargodski, and Rafael Pass. Continuous verifiable delay functions. In Anne Canteaut and Yuval Ishai, editors, _Advances in Cryptology - EUROCRYPT 2020 - 39th Annual International Conference on the Theory and Applications of Cryptographic Techniques, Zagreb, Croatia, May 10-14, 2020, Proceedings, Part III_, volume 12107 of _Lecture Notes in Computer Science_, pages 125–154. Springer, 2020. Springer, 2020. | -| ES18 | Ittay Eyal and Emin Gu ̈n Sirer. Majority is not enough: bitcoin mining is vulnerable. _Commun_. ACM, 61(7):95–102, 2018. | +| ES18 | Ittay Eyal and Emin Gu ̈n Sirer. Majority is not enough: bitcoin mining is vulnerable. _Commun_. ACM, 61(7):95–102, 2018. | | FZ17 | Lei Fan and Hong-Sheng Zhou. iching: A scalable proof-of-stake blockchain in the open setting (or, how to mimic nakamoto’s design via proof-of-stake). _IACR Cryptol. ePrint Arch._, page 656, 2017. | | GKL15 | Juan A. Garay, Aggelos Kiayias, and Nikos Leonardos. The bitcoin backbone protocol: Analysis and applications. In Elisabeth Oswald and Marc Fischlin, editors, _Advances in Cryptology - EUROCRYPT 2015 - 34th Annual International Conference on the Theory and Applications of Cryptographic Techniques, Sofia, Bulgaria, April 26-30, 2015, Proceedings, Part II_, volume 9057 of _Lecture Notes in Computer Science_, pages 281–310. Springer, 2015. | | GKR18 | Peter Gazi, Aggelos Kiayias, and Alexander Russell. Stake-bleeding attacks on proof-of-stake blockchains. In _Crypto Valley Conference on Blockchain Technology, CVCBT 2018, Zug, Switzerland, June 20-22, 2018_, pages 85–92. IEEE, 2018. | @@ -29,10 +29,10 @@ slug: /green-paper-references | Lew21 | Andrew Lewis-Pye. Byzantine generals in the permissionless setting. _CoRR_, abs/2101.07095, 2021. | | LR21 | Andrew Lewis-Pye and Tim Roughgarden. How does blockchain security dictate blockchain implementation? In Yongdae Kim, Jong Kim, Giovanni Vigna, and Elaine Shi, editors, _CCS ’21: 2021 ACM SIGSAC Conference on Computer and Communications Security, Virtual Event, Republic of Korea, November 15 - 19, 2021_, pages 1006–1019. ACM, 2021. | | Pie19a | Krzysztof Pietrzak. Proofs of catalytic space. In Avrim Blum, editor, _10th Innovations in Theoretical Computer Science Conference, ITCS 2019, January 10-12, 2019, San Diego, California, USA_, volume 124 of LIPIcs, pages 59:1–59:25. Schloss Dagstuhl - Leibniz- Zentrum für Informatik, 2019. | -| Pie19b | Krzysztof Pietrzak. Simple verifiable delay functions. In Avrim Blum, editor, 1*0th Innovations in Theoretical Computer Science Conference, ITCS 2019, January 10-12, 2019, San Diego, California, USA*, volume 124 of LIPIcs, pages 60:1–60:15. Schloss Dagstuhl - Leibniz-Zentrum fu ̈r Informatik, 2019. | -| PKF+18 | Sunoo Park, Albert Kwon, Georg Fuchsbauer, Peter Gazi, Joël Alwen, and Krzysztof Pietrzak. Spacemint: A cryptocurrency based on proofs of space. In Sarah Meiklejohn and Kazue Sako, editors, _Financial Cryptography and Data Security - 22nd International Conference, FC 2018, Nieuwpoort, Cura ̧cao, February 26 - March 2, 2018, Revised Selected Papers_, volume 10957 of _Lecture Notes in Computer Science_, pages 480–499. Springer, 2018. | +| Pie19b | Krzysztof Pietrzak. Simple verifiable delay functions. In Avrim Blum, editor, 1*0th Innovations in Theoretical Computer Science Conference, ITCS 2019, January 10-12, 2019, San Diego, California, USA*, volume 124 of LIPIcs, pages 60:1–60:15. Schloss Dagstuhl - Leibniz-Zentrum fu ̈r Informatik, 2019. | +| PKF+18 | Sunoo Park, Albert Kwon, Georg Fuchsbauer, Peter Gazi, Joël Alwen, and Krzysztof Pietrzak. Spacemint: A cryptocurrency based on proofs of space. In Sarah Meiklejohn and Kazue Sako, editors, _Financial Cryptography and Data Security - 22nd International Conference, FC 2018, Nieuwpoort, Cura ̧cao, February 26 - March 2, 2018, Revised Selected Papers_, volume 10957 of _Lecture Notes in Computer Science_, pages 480–499. Springer, 2018. | | PS17 | Rafael Pass and Elaine Shi. The sleepy model of consensus. Rafael Pass and Elaine Shi. The sleepy model of consensus. In Tsuyoshi Takagi and Thomas Peyrin, editors, _Advances in Cryptology - ASIACRYPT 2017 - 23rd International Conference on the Theory and Applications of Cryptology and Information Security, Hong Kong, China, December 3-7, 2017, Proceedings, Part II_, volume 10625 of _Lecture Notes in Computer Science_, pages 380–409. Springer, 2017. Springer, 2017. | -| SNM+21 | Caspar Schwarz-Schilling, Joachim Neu, Barnab ́e Monnot, Aditya Asgaonkar, Ertem Nusret Tas, and David Tse. Three attacks on proof-of-stake ethereum. _IACR Cryptol. ePrint Arch._, page 1413, 2021. | +| SNM+21 | Caspar Schwarz-Schilling, Joachim Neu, Barnab ́e Monnot, Aditya Asgaonkar, Ertem Nusret Tas, and David Tse. Three attacks on proof-of-stake ethereum. _IACR Cryptol. ePrint Arch._, page 1413, 2021. | | SSZ15 | Ayelet Sapirshtein, Yonatan Sompolinsky, and Aviv Zohar. Optimal selfish mining strategies in bitcoin. _CoRR_, abs/1507.06183, 2015. | | Wes20 | Benjamin Wesolowski. Efficient verifiable delay functions. _J. Cryptol._, 33(4):2113–2147, 2020. | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md index c26f12b576..73861a7799 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/green-paper/rational-attackers.md @@ -42,9 +42,11 @@ By the Proposition below delayed gratification and the no slowdown property impl _Proof._ Consider an adversarial miner ${\cal A}$ with an $\alpha$ fraction of the resource and let $\ell$ denote the (expected) number of blocks to be found if everyone would mine honestly. By the no slowdown property, no matter what ${\cal A}$ does the number of blocks found is at least $\ell'\ge (1-\alpha)\cdot\ell$. By delayed gratification, at most $\alpha\cdot\ell$ of those blocks were created by ${\cal A}$, we get a chain quality of By the no slowdown property, no matter what ${\cal A}$ does the number of blocks found is at least $\ell'\ge (1-\alpha)\cdot\ell$. By delayed gratification, at most $\alpha\cdot\ell$ of those blocks were created by ${\cal A}$, we get a chain quality of -$$ \begin{aligned} \textit{chain quality}&=\frac{\text{honest blocks}}{\text{total blocks}}\\ +$$ +\begin{aligned} \textit{chain quality}&=\frac{\text{honest blocks}}{\text{total blocks}}\\ &=\frac{\ell' - \alpha \cdot \ell}{\ell'}\\ &=1-\frac{\alpha\cdot\ell}{\ell'}\\ -&\ge 1-\frac{\alpha\cdot\ell}{(1-\alpha)\cdot \ell}\\ &=1-\frac{\alpha}{1-\alpha} \hspace{10em}\square \end{aligned} $$ +&\ge 1-\frac{\alpha\cdot\ell}{(1-\alpha)\cdot \ell}\\ &=1-\frac{\alpha}{1-\alpha} \hspace{10em}\square \end{aligned} +$$ --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md index 026f0660f6..041427d9bf 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/cat/cat2-upgrade/cat2-issuance.md @@ -164,7 +164,7 @@ If you are unsure whether your CAT used a single- or multi-issuance TAIL, step 1 - You can run either the light wallet or a full node. - You are recommended to have enough mojos to cover transaction fees for the reissuance. The recommended amount is five hundred thousand (500,000) mojos per coin to be reissued. - You are **required** to have a single coin that is large enough to cover the entire reissuance. Even if your XCH balance is sufficient, it may be separated into multiple small coins. The easiest way to ensure that you have a sufficiently large coin is to send a transaction to yourself of at least the total value required. -::: + ::: 3. Use the CAT Admin Tool to select a coin that will be used for issuing the CAT2 tokens. @@ -363,7 +363,7 @@ You need to use the same public/private key pair to sign the CAT2 issuance as yo - You can run either the light wallet or a full node. - You are recommended to have enough mojos to cover transaction fees for the reissuance. The recommended amount is five hundred thousand (500,000) mojos per coin to be reissued. - You are **required** to have a single coin that is large enough to cover the entire reissuance. Even if your XCH balance is sufficient, it may be separated into multiple small coins. The easiest way to ensure that you have a sufficiently large coin is to send a transaction to yourself of at least the total value required. -::: + ::: 3. Use the CAT Admin Tool to select a coin that will be used for issuing the CAT2 tokens. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md index cda71653b8..9fd453a517 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/clawback/clawback-user-guide.md @@ -229,7 +229,7 @@ The receiver's wallet will show a pending transaction, including the value, the - While the transaction is in this state, it does not show up in any of the `Balance` fields in the receiver's wallet. This is because the sender can still claw it back. The receiver should therefore not assume the amount will eventually be claimed. This is because the sender can still claw it back. The receiver should therefore not assume the amount will eventually be claimed. - The timer showing how long until the transaction can be claimed does not begin counting down until the original transaction is confirmed on the blockchain. -::: +:::
)! --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md index c8796dea15..f3852f4042 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/crash-course/intro-to-chialisp.md @@ -132,7 +132,7 @@ Which should produce the following output: 42 ``` -So Chialisp can calculate the [meaning of life](https://en.wikipedia.org/wiki/42_(number)#The_Hitchhiker's_Guide_to_the_Galaxy)! +So Chialisp can calculate the [meaning of life]()! --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md index 018c9f50b9..42bf2bfe49 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-description.md @@ -42,7 +42,7 @@ The singleton comes in two layers -- one permanent and one non-permanent. ### Permanent layer | Setting | Prefarm Value | Description | -|:------- |:------------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------ | :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `wt` | 30 days | Withdrawal Timelock -- When attempting to begin a withdrawal, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback. | | `pc` | 90 days | Payment Clawback -- The minimum number of seconds that must elapse after initiating a withdrawal before the withdrawal can be completed. Clawbacks are possible during this window. | | `rt` | 15 days | Rekey Timelock -- When attempting to begin a standard rekey, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback. For a slow rekey, this amount gets added for each key less than `m` (in addition to the amount of time that would have been required in a standard rekey). | @@ -52,10 +52,10 @@ The singleton comes in two layers -- one permanent and one non-permanent. ### Non-permanent layer | Setting | Initial
Value | Description | -|:------- |:----------------------- |:--------------------------------------------------------------------------- | -| `m` | 3 | The initial number of pubkeys required to do a withdrawal or standard rekey | -| `n` | 5 | The maximum number of pubkeys required to do a withdrawal or standard rekey | -| `pks` | | A comma separated list of pubkey files that will control this money | +| :------ | :---------------- | :-------------------------------------------------------------------------- | +| `m` | 3 | The initial number of pubkeys required to do a withdrawal or standard rekey | +| `n` | 5 | The maximum number of pubkeys required to do a withdrawal or standard rekey | +| `pks` | | A comma separated list of pubkey files that will control this money | ## Allowed Actions @@ -123,10 +123,10 @@ The amount of time before the rekey can begin depends on the number of keys used The following table illustrates a few examples of initiation timelock lengths, for various values of `m` and `k`. For this table, `rt` is set to 15 days and `sp` is set to 45 days (these are both denominated in seconds). The table assumes that `n` (5) and the minimum `k` (1) have not been modified from their default values: | `m` | `k` | Days | Comment | -|:---:|:---:|:----:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :-: | :-: | :--: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 3 | 3 | 15 | Standard rekey, no penalty | -| 3 | 2 | 75 | Slow rekey, `sp` day penalty + 2 \* standard `rt` days | -| 3 | 1 | 90 | Slow rekey, `sp` day penalty + 3 \* `rt` days | +| 3 | 2 | 75 | Slow rekey, `sp` day penalty + 2 \* standard `rt` days | +| 3 | 1 | 90 | Slow rekey, `sp` day penalty + 3 \* `rt` days | | 1 | 1 | 15 | This is a case where, after a prior rekey, `m` was reduced to 1. There is no penalty, even with a single key | | 5 | 3 | 90 | In this case, a lock level increase has been performed, so 5 of 5 keys are required to avoid a penalty | | 5 | 1 | 120 | This is the longest possible initiation timelock duration when `n` is 5 and the minimum `k` is 1. In this case, `m` has been increased to 5, and 1 key is being used for the rekey | @@ -190,11 +190,11 @@ The following table lists the action/consequence, given the current value of `m`
-| `m` | Keys Sniffed | Keys Stolen | Keys Lost | -|:--- |:------------------------------------------------------------------------------------------------------------------------------------------------------- |:-------------------------------------------------------------------- |:-------------------------------------------------------------------- | -| 3 | 0-2: normal rekey
3: lock level increase to 4, normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-2: normal rekey
3-5: drained | 0-2: normal rekey
3-4: slow rekey
5: bricked | -| 4 | 0-3: normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-1: normal rekey
2: slow rekey
3-5: drained | 0-1: normal rekey
2-4: slow rekey
5: bricked | -| 5 | 0-4: normal rekey
5: deadlocked | 0: normal rekey
1-2: slow rekey
3-5: drained | 0: normal rekey
1-4: slow rekey
5: bricked | +| `m` | Keys Sniffed | Keys Stolen | Keys Lost | +| :-- | :------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------- | :------------------------------------------------------- | +| 3 | 0-2: normal rekey
3: lock level increase to 4, normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-2: normal rekey
3-5: drained | 0-2: normal rekey
3-4: slow rekey
5: bricked | +| 4 | 0-3: normal rekey
4: lock level increase to 5, normal rekey
5: deadlocked | 0-1: normal rekey
2: slow rekey
3-5: drained | 0-1: normal rekey
2-4: slow rekey
5: bricked | +| 5 | 0-4: normal rekey
5: deadlocked | 0: normal rekey
1-2: slow rekey
3-5: drained | 0: normal rekey
1-4: slow rekey
5: bricked | --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md index 43bc2318a1..dfd8d4a97b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/custody/custody-tool-user-guide.md @@ -249,13 +249,13 @@ The `cic init` command will initialize the permanent layer of the singleton. **N For this guide, we'll create an example singleton that uses the values listed in the table below. As a reminder, these settings correspond to those used in the [flow chart](https://docs.chia.net/assets/files/chia-custody-tool-5e6e2f18e8f98c0faaf11bdf5fea5971.png). | Flag  | Example
Value | Description | -|:---------- |:----------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-d` | keys_and_sb | The directory where the keys and spend bundles will be stored. | -| `-wt` | 600 seconds | Withdrawal Timelock -- the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback before a withdrawal can be initiated. | -| `-pc` | 1200 seconds | Payment Claw back -- the minimum number of seconds that must elapse after initiating a withdrawal before the withdrawal can be completed. Clawbacks are possible during this window. | -| `-rt` | 300 seconds | Rekey Timelock -- when attempting to begin a standard rekey, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or claw back. For a slow rekey, this amount gets added for each key less than `m`. | -| `-rc` | 600 seconds | Rekey Claw back -- the minimum number of seconds that must elapse after initiating a rekey before the rekey can be completed. Claw backs are possible during this window. | -| `-sp` | 900 seconds | Slow rekey Penalty -- this amount gets added to the Rekey Timelock when a slow rekey is being performed. | +| :--------- | :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `-d` | keys_and_sb | The directory where the keys and spend bundles will be stored. | +| `-wt` | 600 seconds | Withdrawal Timelock -- the minimum number of seconds that must have elapsed since the last withdrawal, rekey or clawback before a withdrawal can be initiated. | +| `-pc` | 1200 seconds | Payment Claw back -- the minimum number of seconds that must elapse after initiating a withdrawal before the withdrawal can be completed. Clawbacks are possible during this window. | +| `-rt` | 300 seconds | Rekey Timelock -- when attempting to begin a standard rekey, this is the minimum number of seconds that must have elapsed since the last withdrawal, rekey or claw back. For a slow rekey, this amount gets added for each key less than `m`. | +| `-rc` | 600 seconds | Rekey Claw back -- the minimum number of seconds that must elapse after initiating a rekey before the rekey can be completed. Claw backs are possible during this window. | +| `-sp` | 900 seconds | Slow rekey Penalty -- this amount gets added to the Rekey Timelock when a slow rekey is being performed. | :::info notes regarding the above table diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md index dee976c9f3..97b4722a9a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-permissions.md @@ -86,7 +86,7 @@ Functionality: Configure a store for uploading Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:--------------------------- | +| :-------- | :----- | :------- | :-------------------------- | | store_id | STRING | True | The store ID, in hex format | Response: `{"handle_upload": [true|false]}` @@ -100,7 +100,7 @@ Functionality: Configure a store for downloading from a mirror Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:-------------------------------------- | +| :-------- | :----- | :------- | :------------------------------------- | | store_id | STRING | True | The store ID, in hex format | | url | STRING | True | The URL of the mirror to download from | @@ -118,11 +118,11 @@ Functionality: Upload data to a store Request Parameters: -| Parameter | Type | Required | Description | -|:-------------------- |:------ |:-------- |:--------------------------- | -| store_id | STRING | True | The store ID, in hex format | +| Parameter | Type | Required | Description | +| :----------------- | :----- | :------- | :-------------------------- | +| store_id | STRING | True | The store ID, in hex format | | full_tree_filename | STRING | True | Name of full tree dat file | -| diff_filename | STRING | True | Name of delta dat file | +| diff_filename | STRING | True | Name of delta dat file | Response: `{"uploaded": [true|false]}` @@ -139,7 +139,7 @@ Functionality: Download a data file from a URI Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:-------------------------------------------------- | +| :-------- | :----- | :------- | :------------------------------------------------- | | url | STRING | True | The URI for the download, eg `"server_info.url"` | | filename | STRING | True | The name of the file to download, eg `"file1.dat"` | @@ -158,7 +158,7 @@ Functionality: Add missing files to a store Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------------------------ | +| :-------- | :----- | :------- | :----------------------------------------------------------------------- | | store_id | STRING | True | The store ID, in hex format | | files | LIST | True | The list of files to be added, for example: `["file1.dat", "file2.dat"]` | @@ -233,10 +233,10 @@ Functionality: Add a new store Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------------- | +| :-------- | :----- | :------- | :---------------------------------------------------------------------------------------------------------- | | store_id | STRING | True | The store ID, in hex format | -| bucket | STRING | True\* | The name of the S3 bucket [* Either `bucket` or `urls` or both is required] | -| urls | LIST | True\* | A list of s3 URLs, for example `["s3://one", "s3://two"]` [* Either `bucket` or `urls` or both is required] | +| bucket | STRING | True\* | The name of the S3 bucket [* Either `bucket` or `urls` or both is required] | +| urls | LIST | True\* | A list of s3 URLs, for example `["s3://one", "s3://two"]` [* Either `bucket` or `urls` or both is required] | Success Response: `{"success": true, "id": store id}` @@ -255,7 +255,7 @@ Functionality: Remove a store Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:--------------------------- | +| :-------- | :----- | :------- | :-------------------------- | | store_id | STRING | True | The store ID, in hex format | Response: `{"success": [true|false], "store_id":store id in hex if successful}` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md index b9e07116b5..42fc256126 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/datalayer/datalayer-user-guide.md @@ -278,7 +278,7 @@ Regardless of the status of `FULL NODE`, you may safely proceed with this tutori - Green dot = full node is synced - `FULL NODE` is missing = you are running in `Wallet Mode` -::: +:::
Synced wallet diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md index bfa66bf165..a441bcc244 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/nft/nft-intro.md @@ -63,7 +63,7 @@ The cost for minting and modifying NFTs is significantly higher. The following c If the mempool is not full, then a 1-mojo fee will be sufficient for any of these spends to be included in the next transaction block. To view the current status of the mempool, see the [Mempool Cost](https://dashboard.chia.net/d/46EAA05E/mempool-transactions-and-fees?orgId=1&viewPanel=40) table on our dashboard site. (If the green line representing the current mempool cost is close to the red line representing the maximum cost, then the mempool is full, and the following table should be used.) | Operation | Cost (approx) | Min fee (mojos) | Cost in USD at $30/XCH | -|:------------------------------- | -------------:|:--------------- |:---------------------- | +| :------------------------------ | ------------: | :-------------- | :--------------------- | | Minting NFT without DID | 53 million | 265 million | $0.00795 | | Minting NFT with DID | 123 million | 615 million | $0.01845 | | Adding a URI to NFT without DID | 41 million | 205 million | $0.00615 | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md index 8631fcf17f..53337fc203 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-developer-guide.md @@ -18,50 +18,50 @@ For more info, see our WalletConnect [command documentation](/walletconnect-comm The following table shows each RPC for Chia WalletConnect dApps, along with a description of what each RPC does, and a link to the equivalent Chia RPC: -| WalletConnect RPC | Chia Wallet RPC | Description | -|:--------------------- |:-------------------------------------------------------------------- |:------------------------------------------------------------------------------------------------- | -| addCATtoken | [create_new_wallet](/wallet-rpc#create_new_wallet) | Create a new wallet for CATs | -| addVCProofs | [vc_add_proofs](/vc-rpc/#vc_add_proofs) | Add a set of proofs to the DB that can be used when spending a VC | -| cancelOffer | [cancel_offer](/wallet-rpc#cancel_offer) | Cancel an offer | -| checkOfferValidity | [check_offer_validity](/wallet-rpc#check_offer_validity) | Check if an offer is valid | -| createNewDIDWallet | [create_new_wallet](/did-rpc/#create_new_wallet) | Create a new DID wallet | -| createOfferForIDs | [create_offer_for_ids](/wallet-rpc#create_offer_for_ids) | Create a new offer | -| getAllOffers | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | -| getCATAssetId | [cat_get_asset_id](/wallet-rpc#cat_get_asset_id) | Retrieve a the asset ID from a CAT wallet | -| getCATWalletInfo | [get_wallets](/wallet-rpc/#get_wallets) | Get CAT Wallet Info | +| WalletConnect RPC | Chia Wallet RPC | Description | +| :-------------------- | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ | +| addCATtoken | [create_new_wallet](/wallet-rpc#create_new_wallet) | Create a new wallet for CATs | +| addVCProofs | [vc_add_proofs](/vc-rpc/#vc_add_proofs) | Add a set of proofs to the DB that can be used when spending a VC | +| cancelOffer | [cancel_offer](/wallet-rpc#cancel_offer) | Cancel an offer | +| checkOfferValidity | [check_offer_validity](/wallet-rpc#check_offer_validity) | Check if an offer is valid | +| createNewDIDWallet | [create_new_wallet](/did-rpc/#create_new_wallet) | Create a new DID wallet | +| createOfferForIDs | [create_offer_for_ids](/wallet-rpc#create_offer_for_ids) | Create a new offer | +| getAllOffers | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | +| getCATAssetId | [cat_get_asset_id](/wallet-rpc#cat_get_asset_id) | Retrieve a the asset ID from a CAT wallet | +| getCATWalletInfo | [get_wallets](/wallet-rpc/#get_wallets) | Get CAT Wallet Info | | getCurrentAddress | [get_next_address](/wallet-rpc#get_next_address)\* | Set `new_address` to `false` to use the current address | | getNextAddress | [get_next_address](/wallet-rpc#get_next_address)\* | Set `new_address` to `true` to create a new address | -| getNFTsCount | [nft_count_nfts](/nft-rpc/#nft_count_nfts) | Count the number of NFTs in a wallet | -| getNFTInfo | [nft_get_info](/nft-rpc/#nft_get_info) | Get info about an NFT | -| getNFTs | [nft_get_nfts](/nft-rpc/#nft_get_nfts) | Show all NFTs in a given wallet | +| getNFTsCount | [nft_count_nfts](/nft-rpc/#nft_count_nfts) | Count the number of NFTs in a wallet | +| getNFTInfo | [nft_get_info](/nft-rpc/#nft_get_info) | Get info about an NFT | +| getNFTs | [nft_get_nfts](/nft-rpc/#nft_get_nfts) | Show all NFTs in a given wallet | | getNFTWalletsWithDIDs | [nft_get_wallets_with_dids](/nft-rpc/#nft_get_wallets_with_dids) | Show all NFT wallets that are associated with DIDs | -| getOfferData | [get_offer](/wallet-rpc#get_offer) | Show the details of one offer | -| getOfferRecord | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | -| getOffersCount | [get_offers_count](/wallet-rpc#get_offers_count) | Obtain the number of offers from the current wallet | -| getOfferSummary | [get_offer_summary](/wallet-rpc#get_offer_summary) | Show a summary of an offer | +| getOfferData | [get_offer](/wallet-rpc#get_offer) | Show the details of one offer | +| getOfferRecord | [get_all_offers](/wallet-rpc#get_all_offers) | Show the details of all offers for this wallet | +| getOffersCount | [get_offers_count](/wallet-rpc#get_offers_count) | Obtain the number of offers from the current wallet | +| getOfferSummary | [get_offer_summary](/wallet-rpc#get_offer_summary) | Show a summary of an offer | | getProofsForRoot | [vc_get_proofs_for_root](/vc-rpc/#vc_get_proofs_for_root) | Given a specified VC root, get any proofs associated with that root | -| getPublicKey | [get_public_key](/daemon-rpc#get_public_key) | Request the user to provide their master public key | -| getSyncStatus | [get_sync_status](/wallet-rpc#get_sync_status) | Show whether the current wallet is syncing or synced | -| getTransaction | [get_transaction](/wallet-rpc#get_transaction) | Get a transaction's details from its ID | -| getVC | [vc_get](/vc-rpc/#vc_get) | Given a launcher ID, get the Verifiable Credential | -| getVCList | [vc_get_list](/vc-rpc/#vc_get_list) | Get a list of Verifiable Credentials | -| getWalletAddresses | [get_wallet_addresses](/daemon-rpc/#get_wallet_addresses) | Get wallet addresses for one or more wallet keys | -| getWalletBalance | [get_wallet_balance](/wallet-rpc#get_wallet_balance) | Obtain the balance (and related info) from a wallet | -| getWalletBalances | [get_wallet_balances](/wallet-rpc/#get_wallet_balances) | Request the asset balances for specific wallets associated with the current wallet key | -| getWallets | [get_wallets](/wallet-rpc#get_wallets) | Show all wallets associated with the current fingerprint, including (by default) coin information | -| logIn | [log_in](/wallet-rpc#log_in) | Log into the wallet with the specified key | -| mintNFT | [nft_mint_nft](/nft-rpc/#nft_mint_nft) | Mint an NFT | -| revokeVC | [vc_revoke](/vc-rpc/#vc_revoke) | Revoke an on chain VC provided the correct DID is available | -| sendTransaction | [send_transaction](/wallet-rpc#send_transaction) | Send a transaction | -| setDIDName | [did_set_wallet_name](/did-rpc/#did_set_wallet_name) | Set the name of a DID wallet | -| setNFTDID | [nft_set_nft_did](/nft-rpc/#nft_set_nft_did) | Set the DID for an NFT | -| showNotification | [get_notifications](/wallet-rpc/#get_notifications) | Show notification with offer or general announcement | -| signMessageByAddress | [sign_message_by_address](/wallet-rpc#sign_message_by_address) | Sign a message using an XCH address without incurring an on-chain transaction | -| signMessageById | [sign_message_by_id](/wallet-rpc#sign_message_by_id) | Sign a message using a DID or NFT ID without incurring an on-chain transaction | -| spendCAT | [cat_spend](/wallet-rpc#cat_spend) | Send CAT funds to another wallet | -| spendClawbackCoins | [spend_clawback_coins](/wallet-rpc/#spend_clawback_coins) | Claw back or claim claw back transaction | -| takeOffer | [take_offer](/wallet-rpc#take_offer) | Take an offer | -| transferNFT | [nft_transfer_nft](/nft-rpc#nft_transfer_nft) | Transfer an NFT to a new wallet address | -| spendVC | [vc_spend](/vc-rpc/#vc_spend) | Add Proofs To Verifiable Credential | -| verifySignature | [verify_signature](/wallet-rpc#verify_signature) | Given a public key, message and signature, verify if it is valid | -| waitForConfirmation | | | +| getPublicKey | [get_public_key](/daemon-rpc#get_public_key) | Request the user to provide their master public key | +| getSyncStatus | [get_sync_status](/wallet-rpc#get_sync_status) | Show whether the current wallet is syncing or synced | +| getTransaction | [get_transaction](/wallet-rpc#get_transaction) | Get a transaction's details from its ID | +| getVC | [vc_get](/vc-rpc/#vc_get) | Given a launcher ID, get the Verifiable Credential | +| getVCList | [vc_get_list](/vc-rpc/#vc_get_list) | Get a list of Verifiable Credentials | +| getWalletAddresses | [get_wallet_addresses](/daemon-rpc/#get_wallet_addresses) | Get wallet addresses for one or more wallet keys | +| getWalletBalance | [get_wallet_balance](/wallet-rpc#get_wallet_balance) | Obtain the balance (and related info) from a wallet | +| getWalletBalances | [get_wallet_balances](/wallet-rpc/#get_wallet_balances) | Request the asset balances for specific wallets associated with the current wallet key | +| getWallets | [get_wallets](/wallet-rpc#get_wallets) | Show all wallets associated with the current fingerprint, including (by default) coin information | +| logIn | [log_in](/wallet-rpc#log_in) | Log into the wallet with the specified key | +| mintNFT | [nft_mint_nft](/nft-rpc/#nft_mint_nft) | Mint an NFT | +| revokeVC | [vc_revoke](/vc-rpc/#vc_revoke) | Revoke an on chain VC provided the correct DID is available | +| sendTransaction | [send_transaction](/wallet-rpc#send_transaction) | Send a transaction | +| setDIDName | [did_set_wallet_name](/did-rpc/#did_set_wallet_name) | Set the name of a DID wallet | +| setNFTDID | [nft_set_nft_did](/nft-rpc/#nft_set_nft_did) | Set the DID for an NFT | +| showNotification | [get_notifications](/wallet-rpc/#get_notifications) | Show notification with offer or general announcement | +| signMessageByAddress | [sign_message_by_address](/wallet-rpc#sign_message_by_address) | Sign a message using an XCH address without incurring an on-chain transaction | +| signMessageById | [sign_message_by_id](/wallet-rpc#sign_message_by_id) | Sign a message using a DID or NFT ID without incurring an on-chain transaction | +| spendCAT | [cat_spend](/wallet-rpc#cat_spend) | Send CAT funds to another wallet | +| spendClawbackCoins | [spend_clawback_coins](/wallet-rpc/#spend_clawback_coins) | Claw back or claim claw back transaction | +| takeOffer | [take_offer](/wallet-rpc#take_offer) | Take an offer | +| transferNFT | [nft_transfer_nft](/nft-rpc#nft_transfer_nft) | Transfer an NFT to a new wallet address | +| spendVC | [vc_spend](/vc-rpc/#vc_spend) | Add Proofs To Verifiable Credential | +| verifySignature | [verify_signature](/wallet-rpc#verify_signature) | Given a public key, message and signature, verify if it is valid | +| waitForConfirmation | | | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md index 337df5750f..f2985d916c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/walletconnect/walletconnect-user-guide.md @@ -242,7 +242,7 @@ Returning to the sample dApp, a new dialog with the response will appear. In thi
- You have now installed, configured, and used the sample dApp. Feel free to test the other functions, as well as create your own! +You have now installed, configured, and used the sample dApp. Feel free to test the other functions, as well as create your own! --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-compression.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-compression.md index fdc8be45ac..a638ec7872 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-compression.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-compression.md @@ -24,16 +24,16 @@ The next sections list three methods to determine the compression level that wil You can use the following table as a basic guide for choosing a compression level. You can use the following table as a basic guide for choosing a compression level. It assumes BladeBit CUDA was used to create K32 plots: |
Level | Size
(GiB) | Relative
Size | Reward
Increase | Min Spec
Harvester | -|:----------------- |:---------------------- |:------------------------- |:--------------------------- |:------------------------------- | -| C0 | 101.4 | 100% | 0% | Pi 4 | -| C1 | 87.5 | 86.3% | 15.9% | Pi 4 | -| C2 | 86.0 | 84.8% | 17.9% | Pi 4 | -| C3 | 84.5 | 83.3% | 20.0% | Pi 4 | -| C4 | 82.9 | 81.8% | 22.3% | Desktop CPU | -| C5 | 81.3 | 80.2% | 24.7% | Fast CPU | -| C6 | 79.6 | 78.5% | 27.4% | Fast CPU | -| C7 | 78.0 | 76.9% | 29.8% | GPU | -| C9 | 75.2 | 74.2% | 34.8% | GPU | +| :---------- | :--------------- | :------------------ | :-------------------- | :------------------------ | +| C0 | 101.4 | 100% | 0% | Pi 4 | +| C1 | 87.5 | 86.3% | 15.9% | Pi 4 | +| C2 | 86.0 | 84.8% | 17.9% | Pi 4 | +| C3 | 84.5 | 83.3% | 20.0% | Pi 4 | +| C4 | 82.9 | 81.8% | 22.3% | Desktop CPU | +| C5 | 81.3 | 80.2% | 24.7% | Fast CPU | +| C6 | 79.6 | 78.5% | 27.4% | Fast CPU | +| C7 | 78.0 | 76.9% | 29.8% | GPU | +| C9 | 75.2 | 74.2% | 34.8% | GPU | The right column (Min Spec Harvester) shows the minimum type of computer required for harvesting at each compression level, where: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-hardware.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-hardware.md index 78da0177e5..4ee4da6078 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-hardware.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-hardware.md @@ -57,13 +57,13 @@ The **BladeBit CUDA** plotter requires an NVIDIA GPU with CUDA capability 5.2 an The following table lists the general plotter types, along with their requirements, for creating k32 plots: -| Processor +
Storage | Plotter
Name(s) | Chia
Version | Comp.
Plots | Compute | Temp
Disk
(GB) | RAM
(GB) | Plot
Times
(min.) | -|:----------------------------- |:---------------------------------------------------- |:------------------------ |:--------------------- |:------- |:---------------------------------- |:------------------ |:------------------------------------- | -| **GPU +
RAM** | BladeBit CUDA | 2.0 | Yes | GPU | None | 256 | 1-3 | -| **GPU +
SSD** | BladeBit CUDA | 2.1 | Yes | GPU | 180 | 128 | 3-5 | -| **CPU +
RAM** | BladeBit RAM | 2.0 | Yes | CPU | None | 416 | 2-5 | -| **CPU +
SSD** | Bladebit Disk
madMAx
ChiaPoS | 2.0 | No | CPU | 512 | 4 | 15-60 | -| **CPU +
HDD** | Bladebit Disk
madMAx
ChiaPoS | 2.0 | No | CPU | 512 | 4 | > 60 | +| Processor +
Storage | Plotter
Name(s) | Chia
Version | Comp.
Plots | Compute | Temp
Disk
(GB) | RAM
(GB) | Plot
Times
(min.) | +| :---------------------- | :--------------------------------------- | :----------------- | :-------------- | :------ | :--------------------- | :----------- | :------------------------ | +| **GPU +
RAM** | BladeBit CUDA | 2.0 | Yes | GPU | None | 256 | 1-3 | +| **GPU +
SSD** | BladeBit CUDA | 2.1 | Yes | GPU | 180 | 128 | 3-5 | +| **CPU +
RAM** | BladeBit RAM | 2.0 | Yes | CPU | None | 416 | 2-5 | +| **CPU +
SSD** | Bladebit Disk
madMAx
ChiaPoS | 2.0 | No | CPU | 512 | 4 | 15-60 | +| **CPU +
HDD** | Bladebit Disk
madMAx
ChiaPoS | 2.0 | No | CPU | 512 | 4 | > 60 | :::note diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md index e82e74dcbf..5af6e0776e 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-how-to.md @@ -74,7 +74,7 @@ You can also choose a custom name for your wallet. Click `NEXT` when you are fin If someone obtains a copy of these words, they can steal your entire wallet, including all of its funds. Be sure to store your recovery phrase in a safe place. Be sure to store your recovery phrase in a safe place. -::: +:::
Wallet seed phrase diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-setup.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-setup.md index 01f63a3ce3..cc4aeabee0 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-setup.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/plotting-setup.md @@ -34,13 +34,13 @@ One thing to keep in mind is that a farming computer only cares about the comple With that in mind, the following table will give you an idea of what compression level to use, given your farming computer. This assumes you will use the Bladbit plotter that comes prepackaged with Chia installations: This assumes you will use the Bladbit plotter that comes prepackaged with Chia installations: |
Level | Size
(GiB) | Relative
Size | Reward
Increase | Farm
With | -|:----------------- |:---------------------- |:------------------------- |:--------------------------- |:---------------------- | -| C0 | 101.4 | 100% | 0% | Pi 4 | -| C1 | 87.5 | 86.3% | 15.9% | Pi 4 | -| C2 | 86.0 | 84.8% | 17.9% | Pi 4 | -| C3 | 84.5 | 83.3% | 20.0% | Pi 4 | -| C4 | 82.9 | 81.8% | 22.3% | Pi 4 | -| C5 | 81.3 | 80.2% | 24.7% | Fast CPU | -| C6 | 79.6 | 78.5% | 27.4% | Fast CPU | -| C7 | 78.0 | 76.9% | 29.8% | GPU | -| C9 | 75.2 | 74.2% | 34.8% | GPU | +| :---------- | :--------------- | :------------------ | :-------------------- | :--------------- | +| C0 | 101.4 | 100% | 0% | Pi 4 | +| C1 | 87.5 | 86.3% | 15.9% | Pi 4 | +| C2 | 86.0 | 84.8% | 17.9% | Pi 4 | +| C3 | 84.5 | 83.3% | 20.0% | Pi 4 | +| C4 | 82.9 | 81.8% | 22.3% | Pi 4 | +| C5 | 81.3 | 80.2% | 24.7% | Fast CPU | +| C6 | 79.6 | 78.5% | 27.4% | Fast CPU | +| C7 | 78.0 | 76.9% | 29.8% | GPU | +| C9 | 75.2 | 74.2% | 34.8% | GPU | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/ssd-endurance.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/ssd-endurance.md index d4b691d878..34ebc48839 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/ssd-endurance.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/plotting/ssd-endurance.md @@ -16,14 +16,14 @@ The fastest plot creation is done completely in memory, but requires a server wi 衡量SSD耐久性的度量标准是以一定的工作负载为基础的写入总量，即TBW。 一般来说，工作负载是根据JEDEC组织的JESD219工作负载来定义的。 An SSD can still plot well beyond meeting its rated TBW limit, because UBER can be measured (when seeing host errors) and retention is not required (Chia plotting requires temporary or ephemeral storage). -| 地块生成程序 | 缓存/内存磁盘 | K=32的写入次数 | -| ------------------- | ------- | --------- | -| Chiapos beta (2020) | 0 | 1.8 TBW | -| Chiapos 2021 | 0 | 1.4 TBW | -| madMAx Chia_plot | 0 | 1.43 TBW | -| madMAx Chia_plot | 110G | 0.396 TBW | -| Bladebit Disk | 0 | 1.225 TBW | -| Bladebit Disk | \>99G | 0.381 TBW | +| 地块生成程序 | 缓存/内存磁盘 | K=32的写入次数 | +| ------------------- | ------------- | -------------- | +| Chiapos beta (2020) | 0 | 1.8 TBW | +| Chiapos 2021 | 0 | 1.4 TBW | +| madMAx Chia_plot | 0 | 1.43 TBW | +| madMAx Chia_plot | 110G | 0.396 TBW | +| Bladebit Disk | 0 | 1.225 TBW | +| Bladebit Disk | \>99G | 0.381 TBW | Consumer NVMe SSDs are generally not recommended due to their lower endurance, and they often employ caching algorithms to faster media (SLC, or single level cell) for great bursty performance. They do not perform well under heavy workload sustained I/O. 虽然有一些高性能的消费级NVMe SSD可以提供出色的生成地块性能，但较低的TBW将导致更快的磨损。 They do not perform well under heavy workload sustained I/O. 虽然有一些高性能的消费级NVMe SSD可以提供出色的生成地块性能，但较低的TBW将导致更快的磨损。 diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/protocol/pool/pool-protocol-specification.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/protocol/pool/pool-protocol-specification.md index 5bf8481d85..4716a96cdd 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/protocol/pool/pool-protocol-specification.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/protocol/pool/pool-protocol-specification.md @@ -187,7 +187,7 @@ This is a BLS signature of the hashed serialization of the following data in the | -------------------- | ------- | | method_name | string | | launcher_id | bytes32 | -| target_puzzle_hash | bytes32 | +| target_puzzle_hash | bytes32 | | authentication_token | uint64 | where `method_name` must be the serialized string `"get_farmer"`, the parameters must be serialized and hashed according to [Signature validation](#signature-validation) and the signature must be signed by the private key of the `authentication_public_key` using the Augmented Scheme in the BLS IETF spec. @@ -439,7 +439,7 @@ This is a BLS signature of the hashed serialization of the following data in the | -------------------- | ------- | | method_name | string | | launcher_id | bytes32 | -| target_puzzle_hash | bytes32 | +| target_puzzle_hash | bytes32 | | authentication_token | uint64 | where `method_name` must be the serialized string `"get_login"` and `target_puzzle_hash` is pool's target puzzle hash (see [GET /pool_info](#get-pool_info)). The parameters must be serialized and hashed according to [Signature validation](#signature-validation) and the signature must be signed by the private key of the `authentication_public_key` using the Augmented Scheme in the BLS IETF spec. diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference-client/key-management.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference-client/key-management.md index 8c1b6653b2..a6f227db89 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference-client/key-management.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference-client/key-management.md @@ -35,7 +35,7 @@ Configuration steps: - Delete the second key: `chia keys delete -f ` - /!\ **Caution**: make sure you have a backup of the 24 words mnemonic or you will lose access to the key for ever. - It should prompt a WARNING message like "Deleting private_key with fingerprint ``" :::warning Using a farmer address which we don't have the private keys for. We searched the first 500 addresses. Consider overriding `` with `` -::: + ::: - Make sure the `` corresponds to your second key wallet address. Your setup is complete. Your machine can farm XCH and rewards will be sent to the key that you stored on paper. Would you need to transfer funds you can add it back to your computer's Chia keychain by doing: `chia keys add` diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/chia-farming-workload.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/chia-farming-workload.md index 32c6369088..b8feb5549a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/chia-farming-workload.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/chia-farming-workload.md @@ -31,12 +31,12 @@ The proof of space construction and the [Proof of Space page](/proof-of-space) c We can estimate the storage workload on a given drive capacity (measured in TB, terabytes) by knowing the k size selected and n number of plots that fit on the drive. -| Drive size (TB) | 4 | 8 | 10 | 12 | 14 | 16 | 18 | 20 | -| --------------- | --:| --:| --:| ---:| ---:| ---:| ---:| ---:| -| k value | 32 | 32 | 32 | 32 | 32 | 32 | 32 | 32 | -| Number of plots | 36 | 73 | 91 | 110 | 128 | 146 | 165 | 183 | -| k value | 34 | 34 | 34 | 34 | 34 | 34 | 34 | 34 | -| Number of plots | 8 | 17 | 21 | 25 | 30 | 34 | 38 | 43 | +| Drive size (TB) | 4 | 8 | 10 | 12 | 14 | 16 | 18 | 20 | +| --------------- | --: | --: | --: | --: | --: | --: | --: | --: | +| k value | 32 | 32 | 32 | 32 | 32 | 32 | 32 | 32 | +| Number of plots | 36 | 73 | 91 | 110 | 128 | 146 | 165 | 183 | +| k value | 34 | 34 | 34 | 34 | 34 | 34 | 34 | 34 | +| Number of plots | 8 | 17 | 21 | 25 | 30 | 34 | 38 | 43 | Events per day, plots passing filter = signage points per day ✕ n plots / filter constant number of reads =(Events per day, plots passing filter ✕ IO Proof quality check) +(IO Full proof of space ✕ Partials per day IOPS average =number of reads per day / 86400 seconds MB read per day = Number of reads ✕ average IO size per request (kB) / 1000 @@ -150,8 +150,8 @@ UBER is defined as "A metric for the rate of occurrence of data errors, equal to Consumer HDDs are rated for less than 1 error per 1014 (sometimes shown as UBER of 10-14). This means that if a consumer reads on 800TB of data, they would expect a single read error on average. -| Device | UBER | Data read per error | -| -------------- | ------- | ------------------- | +| Device | UBER | Data read per error | +| -------------- | ------ | ------------------- | | Consumer HDD | 10\-14 | 800 TB | | Enterprise HDD | 10\-15 | 8 PB | | SSD | 10\-17 | 800 PB | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/faq.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/faq.md index 9d19f5e25a..c5fb826f95 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/faq.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/faq.md @@ -32,7 +32,7 @@ A genesis challenge is the first VDF challenge on a network that uses the Proof ### What is XCH, TXCH, and mojos? -XCH is the currency symbol for Chia. TXCH is the currency symbol currently being used for testnet chias. TXCH has no value and is only used for testing purposes. Chias and testnet chias can be divided up to 12 decimal places (trillionths). The smallest unit of chia, a trillionth of a chia, is called a mojo, as a tribute to [Mojo Nation](https://en.wikipedia.org/wiki/Mnet_(peer-to-peer_network)#Evil_Geniuses_for_a_Better_Tomorrow), a decentralized file storage platform created in the early 2000s by Zooko Wilcox, Bram Cohen, and others. +XCH is the currency symbol for Chia. TXCH is the currency symbol currently being used for testnet chias. TXCH has no value and is only used for testing purposes. Chias and testnet chias can be divided up to 12 decimal places (trillionths). The smallest unit of chia, a trillionth of a chia, is called a mojo, as a tribute to [Mojo Nation](), a decentralized file storage platform created in the early 2000s by Zooko Wilcox, Bram Cohen, and others. ### Chia vs XCH vs mojo vs chia @@ -1618,14 +1618,14 @@ values={[ If installed just for your user: -```powershell +````powershell Set-Alias -Name chia "C:\Users\ If installed just for your user: ```powershell Set-Alias -Name chia "C:\Users\\AppData\Local\Programs\Chia\resources\app.asar.unpacked\daemon\chia.exe" -``` +```` If installed for all users: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/k-sizes.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/k-sizes.md index 0d1a179a13..1e9d718f54 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/k-sizes.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/resources/k-sizes.md @@ -6,16 +6,16 @@ slug: /k-sizes ## K值大小与压缩等级 | 压缩等级 | 地块大小 k=32（GiB） | 地块大小 k=32（GB） | 地块大小 k=33（GiB） | 地块大小 k=34（GiB） | 地块大小 k=35（GiB） | -| ---- | -------------- | ------------- | -------------- | -------------- | -------------- | -| 0 | 101.4 | 108.8 | 208.8 | 429.9 | 884.1 | -| 1 | 87.5 | 94.0 | 179.6 | 368.2 | 754.3 | -| 2 | 86.0 | 92.4 | 176.6 | 362.1 | 742.2 | -| 3 | 84.5 | 90.7 | 173.4 | 355.9 | 729.7 | -| 4 | 82.9 | 89.0 | 170.2 | 349.4 | 716.8 | -| 5 | 81.3 | 87.2 | 167.0 | 343.0 | 704.0 | -| 6 | 79.6 | 85.5 | 163.8 | 336.6 | 691.1 | -| 7 | 78.0 | 83.8 | 160.6 | 330.2 | 678.3 | -| 9 | 75.2 | 80.7 | 154.1 | 315.5 | 645.8 | +| -------- | -------------------- | ------------------- | -------------------- | -------------------- | -------------------- | +| 0 | 101.4 | 108.8 | 208.8 | 429.9 | 884.1 | +| 1 | 87.5 | 94.0 | 179.6 | 368.2 | 754.3 | +| 2 | 86.0 | 92.4 | 176.6 | 362.1 | 742.2 | +| 3 | 84.5 | 90.7 | 173.4 | 355.9 | 729.7 | +| 4 | 82.9 | 89.0 | 170.2 | 349.4 | 716.8 | +| 5 | 81.3 | 87.2 | 167.0 | 343.0 | 704.0 | +| 6 | 79.6 | 85.5 | 163.8 | 336.6 | 691.1 | +| 7 | 78.0 | 83.8 | 160.6 | 330.2 | 678.3 | +| 9 | 75.2 | 80.7 | 154.1 | 315.5 | 645.8 | :::info **k=32**是可用于耕种（farming）的最小地块。 尽管可能会看到k=25，但这仅用于测试目的。 @@ -30,16 +30,16 @@ For a given _k_, the plot size is roughly `((2 * k) + 1) * (2 ** (k - 1)) * 0.78 The following table shows the old size estimation of C0 plots, along with the new estimations: -| k | Old est. size (GB) | New est. size (GB) | -| --:| ------------------:| ------------------:| -| 32 | 106.3648651 | 108.8844003 | -| 33 | 219.2752603 | 224.469379 | -| 34 | 451.641581 | 462.339915 | -| 35 | 929.4652826 | 951.4821439 | -| 36 | 1911.294806 | 1956.568916 | -| 37 | 3927.318095 | 4020.347087 | -| 38 | 8064.093156 | 8255.112685 | -| 39 | 16547.10024 | 16939.06239 | +| k | Old est. size (GB) | New est. size (GB) | +| --: | -----------------: | -----------------: | +| 32 | 106.3648651 | 108.8844003 | +| 33 | 219.2752603 | 224.469379 | +| 34 | 451.641581 | 462.339915 | +| 35 | 929.4652826 | 951.4821439 | +| 36 | 1911.294806 | 1956.568916 | +| 37 | 3927.318095 | 4020.347087 | +| 38 | 8064.093156 | 8255.112685 | +| 39 | 16547.10024 | 16939.06239 | ## Storage requirements for uncompressed plots diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daemon.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daemon.md index 9df237d5e9..83801278fb 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daemon.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daemon.md @@ -51,12 +51,12 @@ values={[ Be sure to replace `username` with your actual username for both the `.crt` and `.key` file. -```powershell +````powershell wscat -n --cert C:\Users\ ```powershell wscat -n --cert C:\Users\\.chia\mainnet\config\ssl\daemon\private_daemon.crt --key C:\Users\\.chia\mainnet\config\ssl\daemon\private_daemon.key -c wss://0.0.0.0:55400 -``` +```` @@ -134,7 +134,7 @@ Usage: chia rpc daemon [OPTIONS] exit [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -174,7 +174,7 @@ Usage: chia rpc daemon [OPTIONS] get_routes [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -230,7 +230,7 @@ Usage: chia rpc daemon [OPTIONS] get_status [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -265,7 +265,7 @@ Usage: chia rpc daemon [OPTIONS] get_version [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -300,17 +300,17 @@ Usage: chia rpc daemon [OPTIONS] get_wallet_addresses [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------------- |:------- |:-------- |:------------------------------------------------------------------------------------------- | -| fingerprints | NUMBER | False | List the keys for the specified fingerprints only [Default: list keys for all fingerprints] | -| index | NUMBER | False | Starting index for addresses to list [Default: 0] | -| count | NUMBER | False | Number of addresses to list [Default: 1] | +| Flag | Type | Required | Description | +| :---------------------- | :------ | :------- | :------------------------------------------------------------------------------------------ | +| fingerprints | NUMBER | False | List the keys for the specified fingerprints only [Default: list keys for all fingerprints] | +| index | NUMBER | False | Starting index for addresses to list [Default: 0] | +| count | NUMBER | False | Number of addresses to list [Default: 1] | | non_observer_derivation | BOOLEAN | False | Set to `True` to use non-observer derivation [Default: `False`] |
@@ -388,7 +388,7 @@ Usage: chia rpc daemon [OPTIONS] is_keyring_locked [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -423,14 +423,14 @@ Usage: chia rpc daemon [OPTIONS] is_running [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------- |:------ |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :------ | :----- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | service | STRING | TRUE | The service to query; valid examples include, but are not limited to, "chia_data_layer", "chia_data_layer_http", "chia_wallet", "chia_full_node", "chia_harvester", "chia_farmer", "chia_introducer", "chia_timelord", "chia_timelord_launcher", "chia_full_node_simulator", "chia_seeder", "chia_crawler", "wallet_ui" |
@@ -465,7 +465,7 @@ Usage: chia rpc daemon [OPTIONS] keyring_status [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -508,14 +508,14 @@ Usage: chia rpc daemon [OPTIONS] register_service [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:------ |:-------- |:----------------------------------- | +| :------ | :----- | :------- | :---------------------------------- | | service | STRING | TRUE | The name of the service to register |
@@ -546,14 +546,14 @@ Usage: chia rpc daemon [OPTIONS] remove_keyring_passphrase [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------------ |:------ |:-------- |:--------------------------------------------------------------------------------- | +| :----------------- | :----- | :------- | :-------------------------------------------------------------------------------- | | current_passphrase | STRING | True | The current passphrase; if entered correctly, it will be removed from the keyring |
@@ -607,7 +607,7 @@ Usage: chia rpc daemon [OPTIONS] running_services [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -648,14 +648,14 @@ Usage: chia rpc daemon [OPTIONS] set_keyring_passphrase [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------------ |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| :----------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | current_passphrase | STRING | True | The current passphrase (if none, use an empty string) | | new_passphrase | STRING | True | The new passphrase, by default must be at least 8 characters long | | passphrase_hint | STRING | False | The new passphrase hint, if one is desired | @@ -690,14 +690,14 @@ Usage: chia rpc daemon [OPTIONS] start_service [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:------- |:-------- |:------------------------------------------------------------- | +| :------ | :------ | :------- | :------------------------------------------------------------ | | service | STRING | True | The service to start | | testing | Boolean | False | If `true`, then test the start_service RPC [Default: `false`] | @@ -733,14 +733,14 @@ Usage: chia rpc daemon [OPTIONS] stop_service [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:------ |:-------- |:------------------- | +| :------ | :----- | :------- | :------------------ | | service | STRING | True | The service to stop |
@@ -774,14 +774,14 @@ Usage: chia rpc daemon [OPTIONS] unlock_keyring [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:------ |:-------- |:--------------------------------- | +| :--- | :----- | :------- | :-------------------------------- | | key | STRING | False | The key to unlock [Default: None] |
@@ -813,14 +813,14 @@ Usage: chia rpc daemon [OPTIONS] validate_keyring_passphrase [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:------ |:-------- |:---------------- | +| :--- | :----- | :------- | :--------------- | | key | STRING | True | The key to check |
@@ -854,14 +854,14 @@ Usage: chia rpc daemon [OPTIONS] get_keys_for_plotting [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------ |:------ |:-------- |:------------------------------------------------------------------------------------------- | +| :----------- | :----- | :------- | :------------------------------------------------------------------------------------------ | | fingerprints | NUMBER | False | List the keys for the specified fingerprints only [Default: list keys for all fingerprints] |
@@ -900,7 +900,7 @@ Usage: chia rpc daemon [OPTIONS] get_plotters [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -953,14 +953,14 @@ Usage: chia rpc daemon [OPTIONS] start_plotting [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------- |:-------- |:---------------------------------------------------------------------- | +| :-------- | :------ | :------- | :--------------------------------------------------------------------- | | service | STRING | True | The plotting service to use | | plotter | STRING | False | The plotter to use [Default: "chiapos"] | | delay | INTEGER | False | The number of seconds to delay before starting to plot [Default: 0] | @@ -988,14 +988,14 @@ Usage: chia rpc daemon [OPTIONS] stop_plotting [REQUEST] Options: Stop creating a plot | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:------ |:-------- |:----------------------------------- | +| :--- | :----- | :------- | :---------------------------------- | | id | STRING | True | The ID of the plot to stop creating |
@@ -1028,14 +1028,14 @@ Usage: chia rpc daemon [OPTIONS] add_private_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:------ |:-------- |:------------------------------------------------ | +| :------- | :----- | :------- | :----------------------------------------------- | | mnemonic | STRING | True | The mnemonic word list (see below for details) | | label | STRING | False | The label to assign for this key [Default: None] | @@ -1139,14 +1139,14 @@ Usage: chia rpc daemon [OPTIONS] check_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | -|:--------- |:------ |:-------- | +| :-------- | :----- | :------- | | root_path | STRING | True | --- @@ -1160,7 +1160,7 @@ Usage: chia rpc daemon [OPTIONS] delete_all_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1185,14 +1185,14 @@ Usage: chia rpc daemon [OPTIONS] delete_key_by_fingerprint [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------- |:-------- |:-------------------------------------------- | +| :---------- | :------ | :------- | :------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose key you want to delete | Note that this command will fail if the OS key ring is locked. @@ -1243,7 +1243,7 @@ Usage: chia rpc daemon [OPTIONS] get_all_private_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1289,7 +1289,7 @@ Usage: chia rpc daemon [OPTIONS] get_first_private_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1327,14 +1327,14 @@ Usage: chia rpc daemon [OPTIONS] get_key_for_fingerprint [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------- |:-------- |:------------------------------------------------------- | +| :---------- | :------ | :------- | :------------------------------------------------------ | | fingerprint | INTEGER | False | The fingerprint to look up [Default: get the first key] |
@@ -1367,14 +1367,14 @@ Usage: chia rpc daemon [OPTIONS] get_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------------- |:------- |:-------- |:------------------------------------------------------------------- | +| :-------------- | :------ | :------- | :------------------------------------------------------------------ | | fingerprint | INTEGER | True | The fingerprint whose key you want to look up | | include_secrets | BOOLEAN | False | Set to `true` to include secrets in the response [Default: `false`] | @@ -1412,14 +1412,14 @@ Usage: chia rpc daemon [OPTIONS] get_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------------- |:------- |:-------- |:------------------------------------------------------------------- | +| :-------------- | :------ | :------- | :------------------------------------------------------------------ | | include_secrets | BOOLEAN | False | Set to `true` to include secrets in the response [Default: `false`] |
@@ -1458,14 +1458,14 @@ Usage: chia rpc daemon [OPTIONS] get_public_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------- |:-------- |:--------------------------------------------- | +| :---------- | :------ | :------- | :-------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose key you want to look up |
@@ -1501,7 +1501,7 @@ Usage: chia rpc daemon [OPTIONS] get_public_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1542,14 +1542,14 @@ Usage: chia rpc daemon [OPTIONS] set_label [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------- |:-------- |:------------------------------------------- | +| :---------- | :------ | :------- | :------------------------------------------ | | fingerprint | INTEGER | True | The fingerprint whose label you want to set | | label | STRING | True | The new label | @@ -1600,14 +1600,14 @@ Usage: chia rpc daemon [OPTIONS] delete_label [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------- |:-------- |:---------------------------------------------- | +| :---------- | :------ | :------- | :--------------------------------------------- | | fingerprint | INTEGER | True | The fingerprint whose label you want to delete |
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md index ea30112c80..7e3d5d9f4b 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/daos.md @@ -57,12 +57,12 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------------------------------------------------------- | ------ | :------- | :---------------------------------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The DAO wallet to which to add funds. Must be of type `DAOWallet` | -| funding_wallet_id | NUMBER | True | The wallet from which the funds will come. Must be of type `STANDARD_WALLET` or `CAT` | -| amount | NUMBER | True | The amount of funds to add, in mojos | -| fee | NUMBER | False | An optional blockchain fee, in mojos \[Default: 0] | +| Flag | Type | Required | Description | +| :---------------- | ------ | :------- | :------------------------------------------------------------------------------------ | +| wallet_id | NUMBER | True | The DAO wallet to which to add funds. Must be of type `DAOWallet` | +| funding_wallet_id | NUMBER | True | The wallet from which the funds will come. Must be of type `STANDARD_WALLET` or `CAT` | +| amount | NUMBER | True | The amount of funds to add, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos \[Default: 0] |
Example @@ -200,10 +200,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------------------------------- | ------ | :------- | :------------------------------------------------------------------------------------------------------------ | +| Flag | Type | Required | Description | +| :----------- | ------ | :------- | :-------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet whose filter level you would like to adjust. Must be of type `DAOWallet` | -| filter_level | NUMBER | True | The new filter level. Propos with fewer votes than this will not be shown. | +| filter_level | NUMBER | True | The new filter level. Propos with fewer votes than this will not be shown. | --- @@ -222,11 +222,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | ------ | :------- | :---------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :---------- | ------ | :------- | :------------------------------------------------------------------------------------ | | wallet_id | NUMBER | True | The ID of the wallet that contains the proposal to close. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal to close | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| proposal_id | STRING | True | The ID of the proposal to close | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -245,12 +245,12 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :--------------------------------- | ------ | :------- | :------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :------------ | ------ | :------- | :--------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO wallet to use for creating the proposal. Must be of type `DAOWallet` | -| proposal_type | STRING | True | Must be either `spend`, `update`, or `mint` | -| vote_amount | NUMBER | False | The number of votes to add | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| proposal_type | STRING | True | Must be either `spend`, `update`, or `mint` | +| vote_amount | NUMBER | False | The number of votes to add | +| fee | NUMBER | False | An optional blockchain fee, in mojos | Proposal Types: @@ -264,38 +264,38 @@ If the proposal is of type `spend`, then `additions` may optionally be included `additions` is a list with the following elements: -| Element | Required | Description | -| :------------------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | +| Element | Required | Description | +| :---------- | :------- | :-------------------------------------------------- | | asset_id | False | The asset_id of the funds to spend \[Default: None] | -| puzzle_hash | True | The puzzle_hash of the funds to spend | -| amount | True | The amount, in mojos, to spend | +| puzzle_hash | True | The puzzle_hash of the funds to spend | +| amount | True | The amount, in mojos, to spend | If the proposal is of type `spend`, and `additions` is not included, then the following **request parameters** will be used instead: -| Parameter | Required | Description | -| :--------------------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | +| Parameter | Required | Description | +| :------------ | :------- | :-------------------------------------------------- | | asset_id | False | The asset_id of the funds to spend \[Default: None] | -| inner_address | True | The inner address of the funds to spend | -| amount | True | The amount, in mojos, to spend | +| inner_address | True | The inner address of the funds to spend | +| amount | True | The amount, in mojos, to spend | If the proposal is of type `update`, then the **request parameter** `new_dao_rules` is required. `new_dao_rules` is a list of optional rules to update. If a rule is missing from this list, it will not be updated: -| Rule | Required | Description | -| :------------------------------------------------------------- | :------- | :----------------------------------------------------------------------------------------------------------------- | -| proposal_timelock | False | The new minimum number of blocks before a proposal can close | -| soft_close_length | False | The number of blocks a proposal must remain unspent before closing | -| attendance_required | False | The minimum number of votes a proposal must receive to be accepted | -| pass_percentage | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | -| self_destruct_length | False | The number of blocks required before a proposal can be automatically removed | -| oracle_spend_delay | False | The number of blocks required between oracle spends of the treasury | +| Rule | Required | Description | +| :------------------- | :------- | :------------------------------------------------------------------------------------------------- | +| proposal_timelock | False | The new minimum number of blocks before a proposal can close | +| soft_close_length | False | The number of blocks a proposal must remain unspent before closing | +| attendance_required | False | The minimum number of votes a proposal must receive to be accepted | +| pass_percentage | False | The percentage of 'yes' votes in basis points a proposal must receive to be accepted. 100% = 10000 | +| self_destruct_length | False | The number of blocks required before a proposal can be automatically removed | +| oracle_spend_delay | False | The number of blocks required between oracle spends of the treasury | If the proposal is of type `mint`, then the following **request parameters** are required: -| Parameter | Required | Description | -| :----------------------------------------------------------- | :------- | :------------------------------------------- | -| amount | True | The number of DAO CATs to mint | +| Parameter | Required | Description | +| :----------------- | :------- | :------------------------------------------- | +| amount | True | The number of DAO CATs to mint | | cat_target_address | True | The xch address that will receive the tokens | --- @@ -315,11 +315,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | ------ | :------- | :--------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | ------ | :------- | :----------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet from which to release the DAO CATs. Must be of type `DAOWallet` | -| coins | STRING | False | A list of coin IDs to release | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| coins | STRING | False | A list of coin IDs to release | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -338,10 +338,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | ------ | :------- | :--------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | ------ | :------- | :----------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet from which to release the DAO CATs. Must be of type `DAOWallet` | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -360,8 +360,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | ------ | :------- | :------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | ------ | :------- | :------------------------------------------------------------------- | | wallet_id | NUMBER | True | The wallet from which to list proposals; must be of type `DAOWallet` |
@@ -424,10 +424,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | ------ | :------- | :-------------------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :---------- | ------ | :------- | :---------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the DAO wallet from which to look up a proposal's status. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal whose status you would like to show | +| proposal_id | STRING | True | The ID of the proposal whose status you would like to show |
Example @@ -499,8 +499,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | ------ | :------- | :--------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | ------ | :------- | :----------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO wallet from which to show the rules. Must be of type `DAOWallet` |
@@ -548,8 +548,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | ------ | :------- | :------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | ------ | :------- | :--------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO whose treasury balance you would like to show. Must be of type `DAOWallet` |
@@ -591,8 +591,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | ------ | :------- | :---------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | ------ | :------- | :------------------------------------------------------------------------------ | | wallet_id | NUMBER | True | The DAO wallet whose ID you would like to retrieve. Must be of type `DAOWallet` |
@@ -627,10 +627,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | ------ | :------- | :----------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :---------- | ------ | :------- | :------------------------------------------------------------------- | | wallet_id | NUMBER | True | The DAO wallet where the proposal lives. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal whose details you would like to show | +| proposal_id | STRING | True | The ID of the proposal whose details you would like to show |
Example @@ -685,10 +685,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | ------ | :------- | :-------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | ------ | :------- | :---------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet from which to lock DAO CATs. Must be of type `DAOWallet` | -| amount | NUMBEr | True | The amount of CATs to lock for voting | +| amount | NUMBEr | True | The amount of CATs to lock for voting | --- @@ -707,12 +707,12 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------------------------------------------------- | ------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the wallet where the proposal lives. Must be of type `DAOWallet` | -| proposal_id | STRING | True | The ID of the proposal on which you would like to vote | -| vote_amount | NUMBER | False | The number of DAO CATs to use for this vote \[Default: None] | -| is_yes_vote | BOOLEAN | True | A boolean indicating whether this vote is "yes" (`true`) or "no" (`false`) | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| Flag | Type | Required | Description | +| :---------- | ------- | :------- | :------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the wallet where the proposal lives. Must be of type `DAOWallet` | +| proposal_id | STRING | True | The ID of the proposal on which you would like to vote | +| vote_amount | NUMBER | False | The number of DAO CATs to use for this vote \[Default: None] | +| is_yes_vote | BOOLEAN | True | A boolean indicating whether this vote is "yes" (`true`) or "no" (`false`) | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md index 717f67a364..5872cbd55a 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/datalayer.md @@ -55,14 +55,14 @@ Usage: chia rpc data_layer [OPTIONS] add_mirror [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------ |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | +| :----- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------- | | id | TEXT | True | The hexadecimal ID of the store to mirror | | urls | TEXT | True | A list of URLs where the mirror will reside | | amount | INTEGER | True | The number of mojos to spend to create the mirror. In theory, mirrors with a higher `amount` will be prioritized | @@ -100,16 +100,16 @@ Usage: chia rpc data_layer [OPTIONS] add_missing_files [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------- | -| ids | TEXT | False | A list of hexadecimal store IDs to restore (default: all subscribed stores) | -| override | BOOLEAN | False | If `True`, will overwrite files that already exist (default: `False`) | +| Flag | Type | Required | Description | +| :--------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------- | +| ids | TEXT | False | A list of hexadecimal store IDs to restore (default: all subscribed stores) | +| override | BOOLEAN | False | If `True`, will overwrite files that already exist (default: `False`) | | foldername | TEXT | False | The name of the folder where the files to be restored are located (default: `~/.chia/mainnet/data_layer/db/server_files_location_`) |
@@ -175,18 +175,18 @@ Usage: chia rpc data_layer [OPTIONS] batch_update [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:----------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| changelist | TEXT | True | A string representing the changelist | +| Flag | Type | Required | Description | +| :-------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | +| id | TEXT | True | The hexadecimal store ID | +| changelist | TEXT | True | A string representing the changelist | | submit_on_chain | BOOLEAN | False | Specify whether to submit the update to the blockchain (`True`), or to store it locally (`False`). Default: `True` (See info box for details) | -| fee | TEXT | False | Set the fee for the transaction, in mojos | +| fee | TEXT | False | Set the fee for the transaction, in mojos | :::info @@ -393,14 +393,14 @@ Usage: chia rpc data_layer [OPTIONS] cancel_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------- | :------ | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | trade_id | TEXT | True | The `trade_id` of the offer. This is displayed with the response of the [make_offer](#make_offer) RPC | | secure | BOOLEAN | True | If `true`, the offer will be canceled on the blockchain, making it impossible to be accepted later. If `false`, the offer will only be canceled locally. We recommend that you set this to `true` unless you are certain that the offer file has not left your computer | | fee | TEXT | False | If `secure` is `true`, this will set the fee for the transaction, in mojos. If `secure` is `false`, the fee will be ignored | @@ -435,7 +435,7 @@ Usage: chia rpc data_layer [OPTIONS] check_plugins [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -473,14 +473,14 @@ Usage: chia rpc data_layer [OPTIONS] clear_pending_roots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:---- |:-------- |:------------------------ | +| :------- | :--- | :------- | :----------------------- | | store_id | TEXT | True | The hexadecimal store ID |
@@ -517,14 +517,14 @@ Usage: chia rpc data_layer [OPTIONS] create_data_store [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:----------------------------------------- | +| :--- | :--- | :------- | :---------------------------------------- | | fee | TEXT | False | Set the fee for the transaction, in mojos |
@@ -688,14 +688,14 @@ Usage: chia rpc data_layer [OPTIONS] delete_key [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:----------------------------------------- | +| :--- | :--- | :------- | :---------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | key | TEXT | True | The hexadecimal key | | fee | TEXT | False | Set the fee for the transaction, in mojos | @@ -731,14 +731,14 @@ Usage: chia rpc data_layer [OPTIONS] delete_mirror [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:---------------------------------------------------------------------------------------- | +| :--- | :--- | :------- | :--------------------------------------------------------------------------------------- | | id | TEXT | True | The `coin_id` of the mirror to delete, obtainable by running [get_mirrors](#get_mirrors) | | fee | TEXT | False | Set the fee for the transaction, in mojos | @@ -787,14 +787,14 @@ Usage: chia rpc data_layer [OPTIONS] get_ancestors [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:---------------------------------------- | +| :--- | :--- | :------- | :--------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | hash | TEXT | True | The hash from which to display ancestors | @@ -846,17 +846,17 @@ Usage: chia rpc data_layer [OPTIONS] get_keys [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:--------------- |:------ |:-------- |:------------------------------------------------------------------------------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| root_hash | TEXT | False | The root hash from which to obtain data | -| page | NUMBER | False | Enables pagination of the output and requests a specific page | +| Flag | Type | Required | Description | +| :------------ | :----- | :------- | :------------------------------------------------------------------------------------------------ | +| id | TEXT | True | The hexadecimal store ID | +| root_hash | TEXT | False | The root hash from which to obtain data | +| page | NUMBER | False | Enables pagination of the output and requests a specific page | | max_page_size | NUMBER | False | Set how many bytes to be included in a page. Only used if pagination is enabled. Default is 40 MB | :::info @@ -902,17 +902,17 @@ Usage: chia rpc data_layer [OPTIONS] get_keys_values [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------------:|:------:|:--------:|:------------------------------------------------------------------------------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| root_hash | TEXT | False | The root hash from which to obtain data | -| page | NUMBER | False | Enables pagination of the output and requests a specific page | +| Flag | Type | Required | Description | +| :-----------: | :----: | :------: | :------------------------------------------------------------------------------------------------ | +| id | TEXT | True | The hexadecimal store ID | +| root_hash | TEXT | False | The root hash from which to obtain data | +| page | NUMBER | False | Enables pagination of the output and requests a specific page | | max_page_size | NUMBER | False | Set how many bytes to be included in a page. Only used if pagination is enabled. Default is 40 MB | :::info @@ -1026,18 +1026,18 @@ Usage: chia rpc data_layer [OPTIONS] get_kv_diff [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:--------------- |:------ |:-------- |:------------------------------------------------------------------------------------------------- | -| id | TEXT | True | The hexadecimal store ID | -| hash_1 | TEXT | True | The first hash to compare | -| hash_2 | TEXT | True | The second hash to compare | -| page | NUMBER | False | Enables pagination of the output and requests a specific page | +| Flag | Type | Required | Description | +| :------------ | :----- | :------- | :------------------------------------------------------------------------------------------------ | +| id | TEXT | True | The hexadecimal store ID | +| hash_1 | TEXT | True | The first hash to compare | +| hash_2 | TEXT | True | The second hash to compare | +| page | NUMBER | False | Enables pagination of the output and requests a specific page | | max_page_size | NUMBER | False | Set how many bytes to be included in a page. Only used if pagination is enabled. Default is 40 MB | :::info @@ -1088,14 +1088,14 @@ Usage: chia rpc data_layer [OPTIONS] get_local_root [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters:s | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:------------------------ | +| :--- | :--- | :------- | :----------------------- | | id | TEXT | True | The hexadecimal store ID |
@@ -1127,14 +1127,14 @@ Usage: chia rpc data_layer [OPTIONS] get_mirrors [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:--------------------------------------------------------- | +| :--- | :--- | :------- | :-------------------------------------------------------- | | id | TEXT | True | The hexadecimal ID of the store for which to list mirrors |
@@ -1174,7 +1174,7 @@ Usage: chia rpc data_layer [OPTIONS] get_owned_stores [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1211,14 +1211,14 @@ Usage: chia rpc data_layer [OPTIONS] get_proof [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:----------- |:-------- |:------------------------------------------- | +| :------- | :---------- | :------- | :------------------------------------------ | | store_id | TEXT | True | The hexadecimal store ID | | keys | STRING LIST | True | A list of keys for which to retrieve proofs | @@ -1269,14 +1269,14 @@ Usage: chia rpc data_layer [OPTIONS] get_root [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:------------------------ | +| :--- | :--- | :------- | :----------------------- | | id | TEXT | True | The hexadecimal store ID |
@@ -1334,14 +1334,14 @@ Usage: chia rpc data_layer [OPTIONS] get_roots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:------------------------------- | +| :--- | :--- | :------- | :------------------------------ | | ids | TEXT | True | A list of hexadecimal store IDs |
@@ -1388,14 +1388,14 @@ Usage: chia rpc data_layer [OPTIONS] get_root_history [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:------------------------ | +| :--- | :--- | :------- | :----------------------- | | id | TEXT | True | The hexadecimal store ID |
@@ -1468,7 +1468,7 @@ Usage: chia rpc data_layer [OPTIONS] get_routes Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1543,14 +1543,14 @@ Usage: chia rpc data_layer [OPTIONS] get_sync_status [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:------------------------ | +| :--- | :--- | :------- | :----------------------- | | id | TEXT | True | The hexadecimal store ID |
@@ -1587,14 +1587,14 @@ Usage: chia rpc data_layer [OPTIONS] get_value [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:---- |:-------- |:--------------------------------------- | +| :-------- | :--- | :------- | :-------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | key | TEXT | True | The hexadecimal key | | root_hash | TEXT | False | The root hash from which to obtain data | @@ -1636,14 +1636,14 @@ Usage: chia rpc data_layer [OPTIONS] insert [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:---- |:-------- |:----------------------------------------- | +| :---- | :--- | :------- | :---------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | key | TEXT | True | The hexadecimal key | | value | TEXT | True | The hexadecimal value | @@ -1700,14 +1700,14 @@ Usage: chia rpc data_layer [OPTIONS] make_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:---- |:-------- |:--------------------------------------------------------- | +| :---- | :--- | :------- | :-------------------------------------------------------- | | maker | TEXT | True | The hexadecimal ID of the store for which to list mirrors | | fee | TEXT | False | Set the fee for the offer, in mojos | @@ -1908,14 +1908,14 @@ Usage: chia rpc data_layer [OPTIONS] remove_subscriptions [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:---------------------------------------- | +| :--- | :--- | :------- | :--------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | urls | TEXT | True | A list of URLs from which to unsubscribe | @@ -1947,14 +1947,14 @@ Usage: chia rpc data_layer [OPTIONS] submit_pending_root [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:------------------------ | +| :--- | :--- | :------- | :----------------------- | | id | TEXT | True | The hexadecimal store ID | --- @@ -1968,14 +1968,14 @@ Usage: chia rpc data_layer [OPTIONS] subscribe [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:------------------------------------------------------------------------ | +| :--- | :--- | :------- | :----------------------------------------------------------------------- | | id | TEXT | True | The hexadecimal store ID | | urls | TEXT | True | A list of URLs where the data store resides. This list can be left blank | @@ -2028,7 +2028,7 @@ Usage: chia rpc data_layer [OPTIONS] subscriptions [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -2069,14 +2069,14 @@ Usage: chia rpc data_layer [OPTIONS] take_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:---- |:-------- |:------------------------------------------------------------------------------------------------------ | +| :---- | :--- | :------- | :----------------------------------------------------------------------------------------------------- | | offer | TEXT | False | The offer, in JSON format (the output from the `make_offer` RPC). Includes Maker and Taker information | | fee | TEXT | False | Set the fee for the offer, in mojos | @@ -2181,14 +2181,14 @@ Usage: chia rpc data_layer [OPTIONS] unsubscribe [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:---- |:-------- |:--------------------------------------------------------- | +| :--- | :--- | :------- | :-------------------------------------------------------- | | id | TEXT | True | The hexadecimal ID of the store from which to unsubscribe | :::info @@ -2229,14 +2229,14 @@ Usage: chia rpc data_layer [OPTIONS] verify_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:---- |:-------- |:------------------------------------------------------------------------------------------------------ | +| :---- | :--- | :------- | :----------------------------------------------------------------------------------------------------- | | offer | TEXT | False | The offer, in JSON format (the output from the `make_offer` RPC). Includes Maker and Taker information |
@@ -2291,16 +2291,16 @@ Usage: chia rpc data_layer [OPTIONS] verify_proof [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------- |:------ |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| store_proofs | STRING | True | The proof to verify; requires a `proofs` parameter, which must contain the following parameters: `key_clvm_hash`, `value_clvm_hash`, `node_hash`, `layers`. See the example for usage. | -| coin_id | STRING | True | The ID of the coin to retrieve | +| Flag | Type | Required | Description | +| :---------------- | :----- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| store_proofs | STRING | True | The proof to verify; requires a `proofs` parameter, which must contain the following parameters: `key_clvm_hash`, `value_clvm_hash`, `node_hash`, `layers`. See the example for usage. | +| coin_id | STRING | True | The ID of the coin to retrieve | | inner_puzzle_hash | STRING | True | The proof's inner puzzle hash | Notes about this command: @@ -2351,14 +2351,14 @@ Functionality: Request that the wallet service be logged in to the specified fin Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------ |:-------- |:------------------------------------ | +| :---------- | :----- | :------- | :----------------------------------- | | fingerprint | STRING | True | The fingerprint of the wallet to use |
@@ -2393,14 +2393,14 @@ Usage: chia rpc data_layer [OPTIONS] close_connection [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------:|:----:|:--------:|:-------------------------------------------------------------------------------------- | +| :-----: | :--: | :------: | :------------------------------------------------------------------------------------- | | node_id | TEXT | True | The hex ID of the node to close, obtainable from [`get_connections`](#get_connections) |
@@ -2448,7 +2448,7 @@ Usage: chia rpc data_layer [OPTIONS] get_connections [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -2498,14 +2498,14 @@ Usage: chia rpc data_layer [OPTIONS] open_connection [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:------- |:-------- |:---------------------------------------------------- | +| :--- | :------ | :------- | :--------------------------------------------------- | | host | TEXT | True | The IP or URL of the node to connect to | | port | INTEGER | True | The port through which to connect to the remote node | @@ -2539,7 +2539,7 @@ Note: Inherited from RPC Server Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md index 252d1ef393..c9dd3f844d 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/dids.md @@ -39,20 +39,20 @@ Note: This is part of the wallet RPC API. It is included here to document the on Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -|:---------------------------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------- | -| wallet_type | True | This must be set to `did_wallet` in order to create a DID wallet | -| did_type | True | Set this to `new` to create a new DID | -| amount | True | Number of mojos to add to the DID initially. Minimum value is `1` | -| backup_dids | True | A list of DIDs to be used for recovery. Must match actual DIDs | +| Parameter | Required | Description | +| :----------------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------- | +| wallet_type | True | This must be set to `did_wallet` in order to create a DID wallet | +| did_type | True | Set this to `new` to create a new DID | +| amount | True | Number of mojos to add to the DID initially. Minimum value is `1` | +| backup_dids | True | A list of DIDs to be used for recovery. Must match actual DIDs | | num_of_backup_ids_needed | True | The number of backup DIDs required for recovery. Minimum value is `1`, maximum value is the number of DIDs in `backup_dids` | -| fee | False | An optional blockchain fee, in mojos | +| fee | False | An optional blockchain fee, in mojos |
Example @@ -114,14 +114,14 @@ Usage: chia rpc wallet [OPTIONS] did_create_attest [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:-------------------------------------------- | +| :-------- | :------- | :------------------------------------------- | | wallet_id | True | The Wallet ID for which to create the attest | | coin_name | True | The coin to use for the attest | | pubkey | True | The public key to use for the attest | @@ -224,14 +224,14 @@ Usage: chia rpc wallet [OPTIONS] did_create_backup_file [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:------------------------------------------------------------------ | +| :-------- | :------- | :----------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the coin info |
@@ -265,18 +265,18 @@ Usage: chia rpc wallet [OPTIONS] did_find_lost_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Type | Required | Description | -|:-------------------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | -| coin_id | STRING | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | +| Parameter | Type | Required | Description | +| :----------------- | :----- | :------- | :---------------------------------------------------------------------------------------------------------------------------------- | +| coin_id | STRING | True | The DID ID, launcher ID, or latest coin ID of the DID you want to recover. The most time-efficient of these is the latest coin ID | | recovery_list_hash | STRING | False | Override the recovery list hash of the DID. Only set this if your last DID spend updated the recovery list | -| num_verification | NUMBER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | -| metadata | STRING | False | The new whole metadata in json format | +| num_verification | NUMBER | False | Override the required verification number of the DID. Only set this if your last DID spend updated the required verification number | +| metadata | STRING | False | The new whole metadata in json format |
Example 1 @@ -326,14 +326,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_current_coin_info [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:------------------------------------------------------------------ | +| :-------- | :------- | :----------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the coin info |
@@ -369,14 +369,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:------------------------------------------------------------- | +| :-------- | :------- | :------------------------------------------------------------ | | wallet_id | True | The Wallet ID of the DID wallet for which to get the DID info |
@@ -410,14 +410,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_info [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:------ |:-------- |:--------------------------------------------------------------------------------- | +| :------ | :----- | :------- | :-------------------------------------------------------------------------------- | | coin_id | NUMBER | True | The coin ID of the DID get info (can be in the `0x618...` or `did:chia:16` format |
@@ -457,14 +457,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_information_needed_for_recovery [REQUES Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:----------------------------------------------------------------------------- | +| :-------- | :------- | :---------------------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the recovery information |
@@ -503,14 +503,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_metadata [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:------------------------------------------------------------------ | +| :-------- | :------- | :----------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet for which to get the metadata list |
@@ -546,14 +546,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_pubkey [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:------------------------------------------------------------------- | +| :-------- | :------- | :------------------------------------------------------------------ | | wallet_id | True | The Wallet ID of the DID wallet from which to obtain the public key |
@@ -585,14 +585,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_recovery_list [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:------------------------------------------------------------------ | +| :-------- | :------- | :----------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet for which to get the recovery list |
@@ -629,14 +629,14 @@ Usage: chia rpc wallet [OPTIONS] did_get_wallet_name [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:-------------------------------------------------------- | +| :-------- | :------- | :------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet on which to get the name |
@@ -669,14 +669,14 @@ Usage: chia rpc wallet [OPTIONS] did_message_spend [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------------------- |:------ |:-------- |:--------------------------------------------------------------- | +| :------------------- | :----- | :------- | :-------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the DID wallet from which to spend the message | | coin_announcements | LIST | False | A list of coin announcements to include with the spend | | puzzle_announcements | LIST | False | A list of puzzle announcements to include with the spend | @@ -723,14 +723,14 @@ Usage: chia rpc wallet [OPTIONS] did_recovery_spend [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:----------- |:-------- |:--------------------------------------------------------------------------------------------------------------- | +| :---------- | :------- | :-------------------------------------------------------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet to recover | | attest_data | True | A list of attest files to be used for recovery | | pubkey | False | The public key of the wallet to recover. If this is not provided, a temporary public key will be used instead | @@ -1063,14 +1063,14 @@ Usage: chia rpc wallet [OPTIONS] did_set_wallet_name [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:-------------------------------------------------------- | +| :-------- | :------- | :------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet on which to set the name | | name | True | The new name of the DID wallet | @@ -1125,19 +1125,19 @@ Usage: chia rpc wallet [OPTIONS] did_transfer_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -|:-------------------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | True | The Wallet ID of the DID wallet to transfer | -| inner_address | True | The address of the inner puzzle to which to transfer the DID | -| fee | False | An optional blockchain fee, in mojos | +| Parameter | Required | Description | +| :----------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | True | The Wallet ID of the DID wallet to transfer | +| inner_address | True | The address of the inner puzzle to which to transfer the DID | +| fee | False | An optional blockchain fee, in mojos | | with_recovery_info | False | If `True`, transfer recovery info [Default: `True`] | -| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -1214,14 +1214,14 @@ Usage: chia rpc wallet [OPTIONS] did_update_metadata [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:------------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | True | The Wallet ID of the DID wallet for which to update the metadata | | metadata | False | The updated metadata | | fee | False | An optional blockchain fee, in mojos | @@ -1255,19 +1255,19 @@ Usage: chia rpc wallet [OPTIONS] did_update_recovery_ids [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -|:---------------------------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | True | The Wallet ID of the DID wallet for which to update the recovery IDs | -| new_list | True | The new recovery ID list. Each item from this list will be appended to the existing list | +| Parameter | Required | Description | +| :------------------------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | True | The Wallet ID of the DID wallet for which to update the recovery IDs | +| new_list | True | The new recovery ID list. Each item from this list will be appended to the existing list | | num_verifications_required | False | Optionally set the number of IDs required for wallet recovery. If not set, then the entire updated list will be required by default | -| fee | False | An optional blockchain fee, in mojos | -| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| fee | False | An optional blockchain fee, in mojos | +| reuse_puzhash | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md index 23d4dc186b..c80a71b037 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/farmer.md @@ -38,7 +38,7 @@ Usage: chia rpc farmer [OPTIONS] get_harvesters [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -99,7 +99,7 @@ Usage: chia rpc farmer [OPTIONS] get_harvesters_summary [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -149,14 +149,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_duplicates [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | +| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -196,14 +196,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_invalid [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | +| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -243,14 +243,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_keys_missing [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | +| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -296,14 +296,14 @@ Usage: chia rpc farmer [OPTIONS] get_harvester_plots_valid [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:---------- |:-------- |:-------------------------------------------------------------------------------- | +| :-------- | :--------- | :------- | :------------------------------------------------------------------------------- | | node_id | HEX STRING | True | This node's `node_id`, obtainable from the [get_harvesters](#get_harvesters) RPC | | page | INTEGER | True | The page in the results sequence to list (starts with `0`) | | page_size | INTEGER | True | The number of entries per page to list | @@ -354,14 +354,14 @@ Usage: chia rpc farmer [OPTIONS] get_pool_login_link [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:----------- |:---------- |:-------- |:------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :---------- | :--------- | :------- | :---------------------------------------------------------------------------------------- | | launcher_id | HEX STRING | True | The launcher_id from your pool, obtainable from the [get_pool_state](#get_pool_state) RPC |
@@ -393,7 +393,7 @@ Usage: chia rpc farmer [OPTIONS] get_pool_state [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -470,14 +470,14 @@ Usage: chia rpc farmer [OPTIONS] get_reward_targets [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------------ |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Flag | Type | Required | Description | +| :--------------------- | :------ | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | search_for_private_key | BOOLEAN | True | List whether the private key (sk) is available for both the farmer and pool keys | | max_ph_to_search | INTEGER | False | The maximum number of puzzle hashes to search [Default: 500] If the wallet's derivation index is large, this number may be insufficient to locate the correct puzzle hashes. In this case, you may need to increase this value | @@ -511,7 +511,7 @@ Usage: chia rpc farmer [OPTIONS] get_routes [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -566,14 +566,14 @@ Usage: chia rpc farmer [OPTIONS] get_signage_point [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:---------- |:-------- |:-------------------------------------------------------------------------------------- | +| :------ | :--------- | :------- | :------------------------------------------------------------------------------------- | | sp_hash | HEX STRING | True | The hash of a signage point, listed as `pos_ss_cc_challenge_hash` in the block details |
@@ -613,7 +613,7 @@ Usage: chia rpc farmer [OPTIONS] get_signage_points [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -706,16 +706,16 @@ Usage: chia rpc farmer [OPTIONS] set_payout_instructions [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------- |:---------- |:-------- |:------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :------------------ | :--------- | :------- | :---------------------------------------------------------------------------------------- | | launcher_id | HEX STRING | True | The launcher_id from your pool, obtainable from the [get_pool_state](#get_pool_state) RPC | -| payout_instructions | HEX STRING | True | The puzzle hash to be used as the new `payout_instructions` | +| payout_instructions | HEX STRING | True | The puzzle hash to be used as the new `payout_instructions` |
Example @@ -745,14 +745,14 @@ Usage: chia rpc farmer [OPTIONS] set_reward_targets [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------- |:---------- |:-------- |:---------------------------- | +| :------------ | :--------- | :------- | :--------------------------- | | farmer_target | HEX STRING | False | Set the farmer reward target | | pool_target | HEX STRING | False | Set the pool reward target | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md index 26000624e8..698efd9ae9 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/full-node.md @@ -54,8 +54,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | :--------- | :------- | :--------------------------- | +| Flag | Type | Required | Description | +| :---------- | :--------- | :------- | :--------------------------- | | header_hash | HEX STRING | True | The header hash of the block | :::note @@ -822,8 +822,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | :--------- | :------- | :------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :---------- | :--------- | :------- | :-------------------------------------------------- | | header_hash | HEX STRING | True | Header hash (block identifier) of the block to get. |
@@ -1066,10 +1066,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------------------------------------ | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------- | -| start | INTEGER | True | The start height | -| end | INTEGER | True | The end height (non-inclusive) | +| Flag | Type | Required | Description | +| :------------------ | :------ | :------- | :------------------------------------------------------------------ | +| start | INTEGER | True | The start height | +| end | INTEGER | True | The end height (non-inclusive) | | exclude_header_hash | BOOLEAN | False | Whether to exclude the header hash in the response [Default: false] |
@@ -1390,8 +1390,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | :--------- | :------- | :------------------------ | +| Flag | Type | Required | Description | +| :---------- | :--------- | :------- | :------------------------ | | header_hash | HEX STRING | True | The block's `header_hash` |
@@ -1474,8 +1474,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---- | :------ | :------- | :------------------------------------------------ | +| Flag | Type | Required | Description | +| :---- | :------ | :------- | :----------------------------- | | start | INTEGER | True | The start height (inclusive) | | end | INTEGER | True | The end height (non-inclusive) | @@ -1644,8 +1644,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----- | :------ | :------- | :-------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----- | :------ | :------- | :------------------------------------------ | | height | INTEGER | True | The height to get (must be \<= peak height) | :::note @@ -1754,8 +1754,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | :--------- | :------- | :------------------------ | +| Flag | Type | Required | Description | +| :---------- | :--------- | :------- | :------------------------ | | header_hash | HEX STRING | True | The block's `header_hash` | :::note @@ -2012,8 +2012,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------- | :--------- | :------- | :------------------------ | +| Flag | Type | Required | Description | +| :---------- | :--------- | :------- | :------------------------ | | header_hash | HEX STRING | True | The block's `header_hash` | :::note @@ -2132,11 +2132,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------------------------------------ | :--------- | :------- | :------------------------------------------------------------------------------------- | -| hint | HEX STRING | True | The hint to examine | -| start_height | INTEGER | False | The block height at which to begin the search | -| end_height | INTEGER | False | The block height at which to end the search | +| Flag | Type | Required | Description | +| :------------------ | :--------- | :------- | :------------------------------------------------------------------ | +| hint | HEX STRING | True | The hint to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | | include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) |
@@ -2203,11 +2203,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------------------------------------ | :--------------- | :------- | :------------------------------------------------------------------------------------- | -| names | HEX STRING ARRAY | True | A list of coin_ids to examine | -| start_height | INTEGER | False | The block height at which to begin the search | -| end_height | INTEGER | False | The block height at which to end the search | +| Flag | Type | Required | Description | +| :------------------ | :--------------- | :------- | :------------------------------------------------------------------ | +| names | HEX STRING ARRAY | True | A list of coin_ids to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | | include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) |
@@ -2274,11 +2274,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------------------------------------ | :--------------- | :------- | :------------------------------------------------------------------------------------- | -| parent_ids | HEX STRING ARRAY | True | A list of parent IDs to examine | -| start_height | INTEGER | False | The block height at which to begin the search | -| end_height | INTEGER | False | The block height at which to end the search | +| Flag | Type | Required | Description | +| :------------------ | :--------------- | :------- | :------------------------------------------------------------------ | +| parent_ids | HEX STRING ARRAY | True | A list of parent IDs to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | | include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) |
@@ -2357,11 +2357,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------------------------------------ | :--------- | :------- | :------------------------------------------------------------------------------------- | -| puzzle_hash | HEX STRING | True | The puzzle hash to search for | -| start_height | INTEGER | False | The block height at which to begin the search | -| end_height | INTEGER | False | The block height at which to end the search | +| Flag | Type | Required | Description | +| :------------------ | :--------- | :------- | :------------------------------------------------------------------ | +| puzzle_hash | HEX STRING | True | The puzzle hash to search for | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | | include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) |
@@ -2464,11 +2464,11 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------------------------------------ | :--------------- | :------- | :------------------------------------------------------------------------------------- | -| puzzle_hashes | HEX STRING ARRAY | True | An array of puzzle hashes to examine | -| start_height | INTEGER | False | The block height at which to begin the search | -| end_height | INTEGER | False | The block height at which to end the search | +| Flag | Type | Required | Description | +| :------------------ | :--------------- | :------- | :------------------------------------------------------------------ | +| puzzle_hashes | HEX STRING ARRAY | True | An array of puzzle hashes to examine | +| start_height | INTEGER | False | The block height at which to begin the search | +| end_height | INTEGER | False | The block height at which to end the search | | include_spent_coins | BOOLEAN | False | A boolean indicating whether to include spent coins (default=false) |
@@ -2607,11 +2607,11 @@ Options: Request Parameters: -| Parameter | Type | Required | Description | -| :-------------------------------- | :------------ | :------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Parameter | Type | Required | Description | +| :----------- | :------------ | :------- | ----------------------------------------------------------------------------------------------------------------------------------- | | spend_bundle | FILENAME | True\* | The spend bundle file (in json format) for which to estimate the fee (\* Exactly one of `spend_bundle` or `cost` must be specified) | -| cost | INTEGER | True\* | The CLVM cost for which to estimate the fee (\* Exactly one of `spend_bundle` or `cost` must be specified) | -| target_times | INTEGER ARRAY | True | An array of the targeted times for transaction inclusion, in seconds. Each targeted time must be at least 0 | +| cost | INTEGER | True\* | The CLVM cost for which to estimate the fee (\* Exactly one of `spend_bundle` or `cost` must be specified) | +| target_times | INTEGER ARRAY | True | An array of the targeted times for transaction inclusion, in seconds. Each targeted time must be at least 0 | :::note @@ -2677,8 +2677,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------- | :--------- | :------- | :------------------------------------------------------------------------------ | +| Flag | Type | Required | Description | +| :---- | :--------- | :------- | :----------------------------------------------------------- | | tx_id | HEX STRING | True | The spend bundle hash (tx ID) for which to retrieve the item |
@@ -2851,8 +2851,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :----------------------------- | :----- | :------- | :------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :-------- | :----- | :------- | :--------------------------------------------------------------------------------- | | coin_name | STRING | True | The ID of the coin to retreive. Must be in the mempool in order to return a result |
@@ -3017,8 +3017,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :------------------------------------------------------------------------------------- | :--------- | :------- | :-------------------- | +| Flag | Type | Required | Description | +| :---------------------- | :--------- | :------- | :-------------------- | | older_block_header_hash | HEX STRING | True | The start header hash | | newer_block_header_hash | HEX STRING | True | The end header hash | @@ -3066,10 +3066,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :--------------------------- | :--------- | :------- | :--------------------------------- | +| Flag | Type | Required | Description | +| :------ | :--------- | :------- | :--------------------------------- | | coin_id | HEX STRING | True | Coin ID of the coin to look up | -| height | INTEGER | True | Height at which the coin was spent | +| height | INTEGER | True | Height at which the coin was spent | :::note @@ -3126,10 +3126,10 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :---------------------------------- | :--------- | :------- | :---------------------------------------------------------------------------------------------------------------- | -| sp_hash | HEX STRING | True\* | The hash of the output for a signage point (if it's in the middle of a sub slot) | -| challenge_hash | HEX STRING | True\* | The challenge_hash for the subslot (if it's an end of sub slot challenge) | +| Flag | Type | Required | Description | +| :------------- | :--------- | :------- | :------------------------------------------------------------------------------- | +| sp_hash | HEX STRING | True\* | The hash of the output for a signage point (if it's in the middle of a sub slot) | +| challenge_hash | HEX STRING | True\* | The challenge_hash for the subslot (if it's an end of sub slot challenge) | :::note @@ -3601,8 +3601,8 @@ Options: Request Parameters: -| Flag | Type | Required | Description | -| :-------------------------------- | :--- | :------- | :------------------------------ | +| Flag | Type | Required | Description | +| :----------- | :--- | :------- | :------------------------------ | | spend_bundle | JSON | True | Spend bundle to submit, in JSON |
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md index 67a4040f3e..789b71f567 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/harvester.md @@ -38,14 +38,14 @@ Usage: chia rpc harvester [OPTIONS] add_plot_directory [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:---- |:-------- |:------------------------------------- | +| :------ | :--- | :------- | :------------------------------------ | | dirname | TEXT | True | The full path of the directory to add | :::note @@ -90,14 +90,14 @@ Usage: chia rpc harvester [OPTIONS] delete_plot [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:---- |:-------- |:----------------------------------- | +| :------- | :--- | :------- | :---------------------------------- | | filename | TEXT | True | The file name of the plot to delete | :::note @@ -134,7 +134,7 @@ Usage: chia rpc harvester [OPTIONS] get_plots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -204,7 +204,7 @@ Usage: chia rpc harvester [OPTIONS] get_plot_directories [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -242,7 +242,7 @@ Usage: chia rpc harvester [OPTIONS] get_routes [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -290,7 +290,7 @@ Usage: chia rpc harvester [OPTIONS] refresh_plots [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -330,14 +330,14 @@ Usage: chia rpc harvester [OPTIONS] remove_plot_directory [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:---- |:-------- |:---------------------------------------- | +| :------ | :--- | :------- | :--------------------------------------- | | dirname | TEXT | True | The full path of the directory to remove | :::note diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md index 28f9e6fba0..72586bbcc4 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/nfts.md @@ -37,16 +37,16 @@ Usage: chia rpc wallet [OPTIONS] nft_add_uri [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------- |:---------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :--------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the DID wallet to transfer | -| nft_coin_id | HEX STRING | True | The coin ID of the NFT on which to add a URI | +| nft_coin_id | HEX STRING | True | The coin ID of the NFT on which to add a URI | | key | STRING | True | Must be either `u` (data URI), `mu` (metadata URI), or `lu` (license URI) | | uri | STRING | True | The URI to add | | fee | NUMBER | False | The one-time blockchain fee to be used upon adding a URI | @@ -156,14 +156,14 @@ Usage: chia rpc wallet [OPTIONS] nft_calculate_royalties [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Sub-Parameter | Required | Description | -|:--------------- |:------------------------------------------------------------------------------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :-------------- | :------------------------------------------------------------------------------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | royalty_assets | Each royalty asset requires three sub-parameters, listed on the following lines | False | A list of NFTs for which to calculate royalties. If this parameter is not included, then nothing will be returned | | | asset | True | The asset ID of the NFT to be traded. This is only used for display in the response; a bogus value may be used | | | royalty_address | True | The address where the royalties will be sent. A bogus value may be used | @@ -259,14 +259,14 @@ Usage: chia rpc wallet [OPTIONS] nft_count_nfts [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:---------------------------------------------------------------------------- | +| :-------- | :----- | :------- | :--------------------------------------------------------------------------- | | wallet_id | NUMBER | False | The ID of the wallet in which to count NFTs [Default: null (count all NFTs)] |
@@ -339,14 +339,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_by_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------ |:------ |:-------- |:--------------------- | +| :----- | :----- | :------- | :-------------------- | | did_id | NUMBER | True | The DID ID to examine |
@@ -378,14 +378,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_info [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:---------------------------------------------------- | +| :-------- | :----- | :------- | :--------------------------------------------------- | | coin_id | NUMBER | True | The coin ID of the NFT about which to retrieve info | | wallet_id | NUMBER | False | The Wallet ID of the NFT from which to retrieve info | @@ -509,14 +509,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_nfts [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------ |:-------- |:------------------------------------------------------------------ | +| :---------- | :----- | :------- | :----------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID from which to retrieve the NFTs | | start_index | NUMBER | False | The NFT index at which to start retrieving the NFTs [Default: `0`] | | num | NUMBER | False | The maximum number of NFTs to retrieve [Default: `0`] | @@ -575,7 +575,7 @@ Usage: chia rpc wallet [OPTIONS] nft_get_wallets_with_dids Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -616,14 +616,14 @@ Usage: chia rpc wallet [OPTIONS] nft_get_wallet_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------ | +| :-------- | :----- | :------- | :----------------------------- | | wallet_id | NUMBER | True | The Wallet ID of an NFT wallet |
@@ -655,30 +655,30 @@ Usage: chia rpc wallet [OPTIONS] nft_mint_bulk [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------------ |:------------ |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the NFT wallet to use for bulk minting | -| metadata_list | STRING ARRAY | True | A list of dicts containing the metadata for each NFT to be minted | -| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | -| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | -| target_list | STRING ARRAY | False | A list of wallet addresses where the NFTs will be sent upon minting | +| Flag | Type | Required | Description | +| :--------------------- | :----------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the NFT wallet to use for bulk minting | +| metadata_list | STRING ARRAY | True | A list of dicts containing the metadata for each NFT to be minted | +| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | +| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | +| target_list | STRING ARRAY | False | A list of wallet addresses where the NFTs will be sent upon minting | | mint_number_start | NUMBER | False | The starting point for mint number used in intermediate launcher puzzle. Default: 1 | -| mint_total | NUMBER | False | The total number of NFTs in the collection. Note that this is not necessarily reflective of the number of NFTs this command will create in the spend bundle, which is derived based on the `metadata_list`. For example, you could set `mint_total` to `1000` and pass only 10 dicts in `metadata_list`. | +| mint_total | NUMBER | False | The total number of NFTs in the collection. Note that this is not necessarily reflective of the number of NFTs this command will create in the spend bundle, which is derived based on the `metadata_list`. For example, you could set `mint_total` to `1000` and pass only 10 dicts in `metadata_list`. | | xch_coin_list | STRING ARRAY | False | A list of coins to be used for funding the minting spend. These coins can be created in the future | | xch_change_target | HEX STRING | False | For use with bulk minting, so we can specify the puzzle hash that the change from the funding transaction goes to. | -| new_innerpuzhash | HEX STRING | False | The new inner puzzle hash for the DID once it is spent. For bulk minting we generally don't provide this as the default behaviour is to re-use the existing inner puzzle hash | +| new_innerpuzhash | HEX STRING | False | The new inner puzzle hash for the DID once it is spent. For bulk minting we generally don't provide this as the default behaviour is to re-use the existing inner puzzle hash | | new_p2_puzhash | HEX STRING | False | The new p2 puzzle hash for the DID once it is spent. For bulk minting we generally don't provide this as the default behaviour is to re-use the existing inner puzzle hash | | did_coin_dict | DICTIONARY | False | The did coin to use for minting. Required for bulk minting when the DID coin will be created in the future | | did_lineage_parent_hex | HEX STRING | False | The parent coin to use for the lineage proof in the DID spend. Needed for bulk minting when the coin will be created in the future | | mint_from_did | BOOLEAN | False | Boolean to determine whether to mint from a DID. Default: false | -| fee | NUMBER | False | A blockchain fee to be deducted with each mint | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| fee | NUMBER | False | A blockchain fee to be deducted with each mint | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -785,29 +785,29 @@ Usage: chia rpc wallet [OPTIONS] nft_mint_nft [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------ |:------------ |:-------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| wallet_id | NUMBER | True | The Wallet ID in which to mint an NFT | -| uris | STRING ARRAY | True | A list of URIs to mark the location(s) of the NFT | -| hash | HEX STRING | True | The hash of the NFT's data. This should use sha256 for proper verification against the URI list | -| did_id | STRING | False | Optionally specify the DID to be associated with this NFT | -| meta_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's metadata | -| meta_hash | HEX STRING | False | The hash of the NFT's metadata | -| license_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's license | -| license_hash | HEX STRING | False | The hash of the NFT's license | -| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | -| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | -| target_address | STRING | False | The wallet address of the initial owner of the NFT. This may be the same as the royalty address | | -| edition_number | NUMBER | False | If this NFT has multiple editions (multiple identical copies of an NFT), then this parameter indicates the edition number of this NFT. | -| edition_total | NUMBER | False | If this NFT has multiple editions, then this parameter indicates the total number of editions of this NFT. This parameter should be used if and only if the `edition_number` parameter was also used | -| fee | NUMBER | False | The one-time blockchain fee to be used upon minting the NFT | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| Flag | Type | Required | Description | +| :----------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | +| wallet_id | NUMBER | True | The Wallet ID in which to mint an NFT | +| uris | STRING ARRAY | True | A list of URIs to mark the location(s) of the NFT | +| hash | HEX STRING | True | The hash of the NFT's data. This should use sha256 for proper verification against the URI list | +| did_id | STRING | False | Optionally specify the DID to be associated with this NFT | +| meta_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's metadata | +| meta_hash | HEX STRING | False | The hash of the NFT's metadata | +| license_uris | STRING ARRAY | False | A list of URIs to mark the location(s) of the NFT's license | +| license_hash | HEX STRING | False | The hash of the NFT's license | +| royalty_address | STRING | False | The wallet address of the NFT's artist. This is where royalties will be sent. It could be either an XCH address or a DID address | +| royalty_percentage | NUMBER | False | The royalty that will go to the original artist each time the NFT is sold. The percentage is multiplied by 100 -- for example, to set a 3% royalty, set this value to 300. The default value is 0 | +| target_address | STRING | False | The wallet address of the initial owner of the NFT. This may be the same as the royalty address | | +| edition_number | NUMBER | False | If this NFT has multiple editions (multiple identical copies of an NFT), then this parameter indicates the edition number of this NFT. | +| edition_total | NUMBER | False | If this NFT has multiple editions, then this parameter indicates the total number of editions of this NFT. This parameter should be used if and only if the `edition_number` parameter was also used | +| fee | NUMBER | False | The one-time blockchain fee to be used upon minting the NFT | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example 1 - Mint an NFT without using a DID @@ -985,18 +985,18 @@ Usage: chia rpc wallet [OPTIONS] nft_set_did_bulk [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:--------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :------------ | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | nft_coin_list | STRING ARRAY | True | A list of coin IDs corresponding to the NFTs, along with the current wallet_ids. Syntax: `[{"nft_coin_id": COIN_ID/NFT_ID, "wallet_id": WALLET_ID}, ...]` | -| did_id | STRING | False | The ID of the DID to which to transfer the NFTs. [Default: no DID (reset the NFTs' DIDs)] | -| fee | NUMBER | False | An optional blockchain fee | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| did_id | STRING | False | The ID of the DID to which to transfer the NFTs. [Default: no DID (reset the NFTs' DIDs)] | +| fee | NUMBER | False | An optional blockchain fee | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -1088,16 +1088,16 @@ Usage: chia rpc wallet [OPTIONS] nft_set_nft_did [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID that holds the NFT on which to set the DID | -| nft_coin_id | NUMBER | True | The coin ID of the NFT on which to set the DID | +| nft_coin_id | NUMBER | True | The coin ID of the NFT on which to set the DID | | did_id | NUMBER | False | Optionally specify the DID to be associated with this NFT. If this parameter is not specified, the DID will be Unassigned | | fee | NUMBER | False | The one-time blockchain fee to be used upon adding a URI | | reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | @@ -1270,14 +1270,14 @@ Usage: chia rpc wallet [OPTIONS] nft_set_nft_status [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------------- |:------- |:-------- |:--------------------------------------------------- | +| :------------- | :------ | :------- | :-------------------------------------------------- | | wallet_id | NUMBER | True | The ID of an NFT wallet | | coin_id | NUMBER | True | The coin_id of the NFT on which to set the status | | in_transaction | BOOLEAN | True | A boolean to set the transaction status for the NFT | @@ -1310,18 +1310,18 @@ Usage: chia rpc wallet [OPTIONS] nft_transfer_bulk [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:--------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| nft_coin_list | STRING ARRAY | True | A list of coin IDs corresponding to the NFTs, along with the current wallet_ids. Syntax: `[{"nft_coin_id": COIN_ID/NFT_ID, "wallet_id": WALLET_ID}, ...]` | -| target_address | STRING | True | The address to which to transfer the NFTs | -| fee | NUMBER | False | An optional blockchain fee | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| Flag | Type | Required | Description | +| :------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| nft_coin_list | STRING ARRAY | True | A list of coin IDs corresponding to the NFTs, along with the current wallet_ids. Syntax: `[{"nft_coin_id": COIN_ID/NFT_ID, "wallet_id": WALLET_ID}, ...]` | +| target_address | STRING | True | The address to which to transfer the NFTs | +| fee | NUMBER | False | An optional blockchain fee | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -1404,17 +1404,17 @@ Usage: chia rpc wallet [OPTIONS] nft_transfer_nft [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------------- |:---------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------- | :--------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the NFT to transfer | | target_address | STRING | True | The address to transfer the NFT to. For NFT0 this must be an XCH address. For NFT1 this could also be a DID address | -| nft_coin_id | HEX STRING | True | The coin ID of the NFT to transfer | +| nft_coin_id | HEX STRING | True | The coin ID of the NFT to transfer | | fee | NUMBER | False | The one-time blockchain fee to be used upon transferring the NFT | | reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md index 0c40fcdd11..5c9383a424 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/offers.md @@ -37,17 +37,17 @@ Usage: chia rpc wallet [OPTIONS] cancel_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:-------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | trade_id | STRING | True | The `trade_id` of the Offer to cancel. The `trade_id` of the Offer to cancel. Can be retrieved from an Offer file by calling `cdv inspect spendbundles ` | -| fee | NUMBER | False | An optional fee (in mojos) to include with the cancellation [Default: `0`] | -| secure | BOOLEAN | False | If `true`, then "cancel on blockchain," ie spend the coins being offered. If `false`, then cancel locally [Default: `true`] | +| fee | NUMBER | False | An optional fee (in mojos) to include with the cancellation [Default: `0`] | +| secure | BOOLEAN | False | If `true`, then "cancel on blockchain," ie spend the coins being offered. If `false`, then cancel locally [Default: `true`] | :::note @@ -83,14 +83,14 @@ Usage: chia rpc wallet [OPTIONS] cancel_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------- | +| :--------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------- | | secure | BOOLEAN | True | If `true`, then "cancel on blockchain," ie spend the coins being offered. If `false`, then cancel locally | | fee | NUMBER | False | An optional fee (in mojos) to include with the cancellation [Default: `0`] | | batch_size | NUMBER | False | The number of Offers to cancel in one batch [Default: `5`] | @@ -125,14 +125,14 @@ Usage: chia rpc wallet [OPTIONS] check_offer_validity [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:------ |:-------- |:--------------------------------- | +| :---- | :----- | :------- | :-------------------------------- | | offer | STRING | True | The text of the Offer to validate | :::note @@ -181,25 +181,25 @@ Usage: chia rpc wallet [OPTIONS] create_offer_for_ids [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:----------------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------- | -| offer | OBJECT | True | A dictionary `[str, int]` of the Offer to create (see the examples below for specifics) | -| fee | NUMBER | False | An optional fee (in mojos) to include with the Offer [Default: `0`] | -| validate_only | BOOLEAN | False | Set to `true` to verify the validity of a potential Offer, rather than actually creating an Offer [Default: `false`] | -| driver_dict | OBJECT | False | A dictionary `[str, Any]` containing metadata of the asset being requested, for example an NFT's on-chain metadata | +| Flag | Type | Required | Description | +| :-------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------- | +| offer | OBJECT | True | A dictionary `[str, int]` of the Offer to create (see the examples below for specifics) | +| fee | NUMBER | False | An optional fee (in mojos) to include with the Offer [Default: `0`] | +| validate_only | BOOLEAN | False | Set to `true` to verify the validity of a potential Offer, rather than actually creating an Offer [Default: `false`] | +| driver_dict | OBJECT | False | A dictionary `[str, Any]` containing metadata of the asset being requested, for example an NFT's on-chain metadata | | min_coin_amount | NUMBER | False | The minimum coin size to be included in the Offer [Default: `0`] | | max_coin_amount | NUMBER | False | The maximum coin size to be included in the Offer [Default: `0`] | -| solver | | False | Default: None | -| min_height | NUMBER | False | The minimum block height that must be reached before this Offer becomes valid [Default: `null` (not used)] | -| min_time | NUMBER | False | The minimum UNIX timestamp that must be reached before this Offer becomes valid [Default: `null` (not used)] | -| max_height | NUMBER | False | The maximum block height where this Offer is still considered valid, aka the expiry height [Default: `null` (not used)] | -| max_time | NUMBER | False | The maximum UNIX timestamp where this Offer is stil considered valid, aka the expiry timestamp [Default: `null` (not used)] | +| solver | | False | Default: None | +| min_height | NUMBER | False | The minimum block height that must be reached before this Offer becomes valid [Default: `null` (not used)] | +| min_time | NUMBER | False | The minimum UNIX timestamp that must be reached before this Offer becomes valid [Default: `null` (not used)] | +| max_height | NUMBER | False | The maximum block height where this Offer is still considered valid, aka the expiry height [Default: `null` (not used)] | +| max_time | NUMBER | False | The maximum UNIX timestamp where this Offer is stil considered valid, aka the expiry timestamp [Default: `null` (not used)] | :::note @@ -722,22 +722,22 @@ Usage: chia rpc wallet [OPTIONS] get_all_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | -| start | NUMBER | False | The first Offer to display, inclusive [Default: `0`] | -| end | NUMBER | False | The last Offer to display, exclusive [Default: `10`] | +| Flag | Type | Required | Description | +| :------------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------- | +| start | NUMBER | False | The first Offer to display, inclusive [Default: `0`] | +| end | NUMBER | False | The last Offer to display, exclusive [Default: `10`] | | exclude_my_offers | BOOLEAN | False | If `true`, don't show Offers that originated from this wallet [Default: `false`] | | exclude_taken_offers | BOOLEAN | False | If `true`, don't show any Offers with a status of `CONFIRMED` [Default: `false`] | -| include_completed | BOOLEAN | False | If `true`, show completed Offers [Default: `false`] | -| sort_key | STRING | False | Optionally change the sort order of the results [Default: none] | -| reverse | BOOLEAN | False | If `true`, reverse the results [Default: `false`] | -| file_contents | BOOLEAN | False | If `true`, return a summary for the Offer. If `false`, only return the Offer's basic metadata [Default: `false`] | +| include_completed | BOOLEAN | False | If `true`, show completed Offers [Default: `false`] | +| sort_key | STRING | False | Optionally change the sort order of the results [Default: none] | +| reverse | BOOLEAN | False | If `true`, reverse the results [Default: `false`] | +| file_contents | BOOLEAN | False | If `true`, return a summary for the Offer. If `false`, only return the Offer's basic metadata [Default: `false`] |
Example @@ -844,14 +844,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------- | +| :------------ | :------ | :------- | :--------------------------------------------------------------------------------------------------------------- | | trade_id | STRING | True | The `trade_id` of the Offer | | file_contents | BOOLEAN | False | If `true`, return a summary for the Offer. If `false`, only return the Offer's basic metadata [Default: `false`] | @@ -960,7 +960,7 @@ Functionality: Obtain a count of the number of offers created and taken with thi Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -997,14 +997,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer_summary [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:------- |:-------- |:--------------------------------------------------------------------- | +| :------- | :------ | :------- | :-------------------------------------------------------------------- | | offer | STRING | True | The text of the Offer to summarize | | advanced | BOOLEAN | False | Show advanced information, including expiration time [Default: false] | @@ -1127,14 +1127,14 @@ Usage: chia rpc wallet [OPTIONS] take_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:--------- |:-------- |:--------------------------------------------------------------------- | +| :---- | :-------- | :------- | :-------------------------------------------------------------------- | | offer | FILE PATH | True | The text of the Offer to take (must be in the `PENDING_ACCEPT` state) | | fee | NUMBER | False | An optional fee (in mojos) to include with the Offer [Default: `0`] | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md index 5bb3f8f0df..e12f103bda 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/simulator.md @@ -52,17 +52,17 @@ Usage: chia rpc full_node [OPTIONS] farm_block [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -|:-------------------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| address | True | The address to use to farm the block | +| Parameter | Required | Description | +| :----------------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| address | True | The address to use to farm the block | | guarantee_tx_block | False | Set to `True` to farm a transaction block (ie, farm new blocks until a tx block is farmed); set to `False` to farm the next block, which could also be a transaction block, but is not guaranteed (Default: `False`) | -| blocks | False | Number of blocks to farm. If `guarantee_tx_block` is `True`, then each block will be a transaction block (Default: 1) | +| blocks | False | Number of blocks to farm. If `guarantee_tx_block` is `True`, then each block will be a transaction block (Default: 1) |
Example 1 @@ -115,7 +115,7 @@ Usage: chia rpc full_node [OPTIONS] get_all_blocks [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -222,14 +222,14 @@ Usage: chia rpc full_node [OPTIONS] get_all_coins [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -|:--------------------- |:-------- |:------------------------------------------------------------------------------------- | +| Parameter | Required | Description | +| :------------------ | :------- | :------------------------------------------------------------------------------------ | | include_spent_coins | False | Boolean, if `True` then spent coins will be included in the result (Default: `False`) |
@@ -287,7 +287,7 @@ Usage: chia rpc full_node [OPTIONS] get_all_puzzle_hashes [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -332,7 +332,7 @@ Usage: chia rpc full_node [OPTIONS] get_auto_farming [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -367,7 +367,7 @@ Usage: chia rpc full_node [OPTIONS] get_farming_ph [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -414,18 +414,18 @@ Usage: chia rpc full_node [OPTIONS] reorg_blocks [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -|:------------------------ |:-------- |:------------------------------------------------------------------- | +| Parameter | Required | Description | +| :------------------- | :------- | :------------------------------------------------------------------ | | num_of_blocks_to_rev | False | The number of blocks to go back (Default: 1) | -| num_of_new_blocks | False | The number of blocks to add (Default: 1) | -| revert_all_blocks | False | Boolean, set to `True` to fork all blocks (Default: `False`) | -| random_seed | False | String, used to randomize the seed, which will differentiate reorgs | +| num_of_new_blocks | False | The number of blocks to add (Default: 1) | +| revert_all_blocks | False | Boolean, set to `True` to fork all blocks (Default: `False`) | +| random_seed | False | String, used to randomize the seed, which will differentiate reorgs |
Example 1 @@ -478,14 +478,14 @@ Usage: chia rpc full_node [OPTIONS] revert_blocks [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Required | Description | -|:------------------- |:-------- |:-------------------------------------------------------------- | +| Parameter | Required | Description | +| :---------------- | :------- | :------------------------------------------------------------- | | num_of_blocks | False | The number of blocks to revert (Default: 1) | | delete_all_blocks | False | Boolean, set to `True` to revert all blocks (Default: `False`) | @@ -540,14 +540,14 @@ Usage: chia rpc full_node [OPTIONS] set_auto_farming [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:----------------------------------------- | +| :-------- | :------- | :---------------------------------------- | | auto_farm | True | Boolean to enable or disable auto farming |
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md index ac16319ca2..6fc59ba562 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/vcs.md @@ -37,14 +37,14 @@ Usage: chia rpc wallet [OPTIONS] vc_add_proofs [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:---------- |:-------- |:----------------------------------------------------- | +| :-------- | :--------- | :------- | :---------------------------------------------------- | | proofs | DICTIONARY | True | A dictionary of key/value pairs to be added as proofs |
@@ -77,14 +77,14 @@ Usage: chia rpc wallet [OPTIONS] vc_get [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------ | +| :-------- | :----- | :------- | :----------------------------------------- | | vc_id | STRING | True | The launcher ID of a Verifiable Credential | This RPC returns the `vc_record` representing the specified Verifiable Credential @@ -142,14 +142,14 @@ Usage: chia rpc wallet [OPTIONS] vc_get_list [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------- |:-------- |:----------------------------------------------------- | +| :-------- | :------ | :------- | :---------------------------------------------------- | | start | INTEGER | False | The index to start the list at [default: 0] | | count | INTEGER | False | The maximum number of results to return [default: 50] | @@ -214,14 +214,14 @@ Usage: chia rpc wallet [OPTIONS] vc_get_proofs_for_root [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------------------------ | +| :-------- | :----- | :------- | :----------------------------------------------------------------------- | | root | STRING | True | The tree hash of a set of proofs that have been stored in the dictionary | This RPC returns a dictionary of root hashes mapped to dictionaries of key value pairs of 'proofs'. @@ -258,14 +258,14 @@ Usage: chia rpc wallet [OPTIONS] vc_mint [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Type | Required | Description | -|:-------------- |:------ |:-------- |:------------------------------------------------------------------------------------ | +| :------------- | :----- | :------- | :----------------------------------------------------------------------------------- | | did_id | STRING | True | The ID of the DID that will be minting the VC | | target_address | STRING | False | The address where the VC will be sent upon minting [Default: send to minting wallet] | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -431,20 +431,20 @@ Usage: chia rpc wallet [OPTIONS] vc_spend [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Type | Required | Description | -|:------------------------ |:------ |:-------- |:------------------------------------------------------------------------------------------------------------------- | -| vc_id | STRING | True | The launcher ID of the Verifiable Credential to spend | -| new_puzhash | None | False | The puzzle hash where the VC will be sent (can be derived from an XCH address) | +| Parameter | Type | Required | Description | +| :--------------------- | :----- | :------- | :------------------------------------------------------------------------------------------------------------------ | +| vc_id | STRING | True | The launcher ID of the Verifiable Credential to spend | +| new_puzhash | None | False | The puzzle hash where the VC will be sent (can be derived from an XCH address) | | new_proof_hash | None | False | Can be used to update the vc's proofs -- the new root/proof hash | | provider_inner_puzhash | STRING | False | Can be used to update the vc's proofs -- the proof provider's inner puzzle hash | -| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | -| fee | None | False | An optional blockchain fee, in mojos | +| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | +| fee | None | False | An optional blockchain fee, in mojos |
Example @@ -649,17 +649,17 @@ Usage: chia rpc wallet [OPTIONS] vc_revoke [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Parameter | Type | Required | Description | -|:-------------- |:------- |:-------- |:------------------------------------------------------------------------------------------------------------------- | -| vc_parent_id | STRING | True | The parent ID of the VC coin | -| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | -| fee | INTEGER | False | An optional blockchain fee, in mojos | +| Parameter | Type | Required | Description | +| :------------ | :------ | :------- | :------------------------------------------------------------------------------------------------------------------ | +| vc_parent_id | STRING | True | The parent ID of the VC coin | +| reuse_puzhash | None | False | If this flag is set, then send the VC back to the same puzzle hash it came from [Default: generate new puzzle hash] | +| fee | INTEGER | False | An optional blockchain fee, in mojos |
Example diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md index ba8a59b39a..534f0b2ce0 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/rpc-reference/wallet.md @@ -39,14 +39,14 @@ To run the same command on Windows, you need to escape the quotes with backslash Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:-------- |:---------- |:-------- |:-------------- | +| Flag | Type | Required | Description | +| :------- | :--------- | :------- | :------------------------- | | mnemonic | TEXT ARRAY | True | 一个24字助记词，表示为数组 |
@@ -78,16 +78,16 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------ |:------ |:-------- |:------------------------------------------------------------------ | -| fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` | -| max_ph_to_search | NUMBER | False | 要搜索的拼图哈希的最大数量[默认：100] | +| Flag | Type | Required | Description | +| :--------------- | :----- | :------- | :----------------------------------------------------------------- | +| fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` | +| max_ph_to_search | NUMBER | False | 要搜索的拼图哈希的最大数量[默认：100] |
Example @@ -121,7 +121,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -161,14 +161,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------ |:-------- |:------------------------------------------------------------------ | +| :---------- | :----- | :------- | :----------------------------------------------------------------- | | fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` |
@@ -199,7 +199,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -259,7 +259,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -294,14 +294,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------ |:-------- |:------------------------------------------------------------------ | +| :---------- | :----- | :------- | :----------------------------------------------------------------- | | fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` | :::warning @@ -346,7 +346,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -381,14 +381,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------ |:-------- |:------------------------------------------------------------------ | +| :---------- | :----- | :------- | :----------------------------------------------------------------- | | fingerprint | NUMBER | True | The wallet's fingerprint, obtainable by running `chia wallet show` |
@@ -422,7 +422,7 @@ Usage: chia rpc wallet [OPTIONS] get_auto_claim [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -462,7 +462,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -497,7 +497,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -533,7 +533,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -570,14 +570,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------ |:------ |:-------- |:---------------------------------------------------- | +| :----- | :----- | :------- | :--------------------------------------------------- | | height | NUMBER | True | The block height for which to retrieve the timestamp |
@@ -611,14 +611,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------ |:---------- |:-------- |:------------------------------ | +| :----------- | :--------- | :------- | :----------------------------- | | transactions | TEXT ARRAY | True | A list of transactions to push | --- @@ -632,14 +632,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------ |:---- |:-------- |:-------------------------------------- | +| :----------- | :--- | :------- | :------------------------------------- | | spend_bundle | TEXT | True | The spend bundle (transaction) to push | --- @@ -653,14 +653,14 @@ Usage: chia rpc wallet [OPTIONS] set_auto_claim [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---------- |:------- |:-------- |:------------------------------------------------------------------------ | +| :--------- | :------ | :------- | :----------------------------------------------------------------------- | | enabled | BOOLEAN | TRUE | Set to `true` to enable auto claim, or `false` to disable it | | tx_fee | NUMBER | TRUE | The default transaction fee to be used for claims, in mojos | | min_amount | NUMBER | TRUE | The minimum value, in mojos, of a claim to be included in the auto claim | @@ -720,14 +720,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------ |:------- |:-------- |:------------------------------------------------ | +| :----- | :------ | :------- | :----------------------------------------------- | | enable | BOOLEAN | False | Set to `true` to enable resync [Default: `true`] |
@@ -760,25 +760,25 @@ Usage: chia rpc wallet [OPTIONS] create_new_wallet [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters (all wallet types): | Flag | Type | Required | Description | -|:----------- |:------ |:-------- |:--------------------------------------------------------------------------------------------------------------------- | +| :---------- | :----- | :------- | :-------------------------------------------------------------------------------------------------------------------- | | wallet_type | STRING | True | The type of wallet to create. Must be one of `cat_wallet`, `did_wallet`, `dao_wallet`, `nft_wallet`, or `pool_wallet` | | fee | NUMBER | False | An optional blockchain fee, in mojos | `cat_wallet` Parameters: -| Flag | Type | Required | Description | -|:-------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------------------------- | -| mode | STRING | True | Must be either `new` of `existing` | -| name | STRING | False | The name of the wallet to create or modify [Default: `CAT` followed by the beginning of the CAT ID] | -| amount | NUMBER | True\* | \*Required if `mode` is `new`. Specify the value, in mojos, of this wallet | -| asset_id | STRING | True\* | \*Required if `mode` is `existing`. *Required if `mode` is `existing`. Specify the `asset_id` of the wallet to update | +| Flag | Type | Required | Description | +| :------- | :----- | :------- | :--------------------------------------------------------------------------------------------------------------------- | +| mode | STRING | True | Must be either `new` of `existing` | +| name | STRING | False | The name of the wallet to create or modify [Default: `CAT` followed by the beginning of the CAT ID] | +| amount | NUMBER | True\* | \*Required if `mode` is `new`. Specify the value, in mojos, of this wallet | +| asset_id | STRING | True\* | \*Required if `mode` is `existing`. \*Required if `mode` is `existing`. Specify the `asset_id` of the wallet to update |
Example 1 (CAT wallet with name) @@ -888,14 +888,14 @@ CAT 348dfae821c76f0a...: `did_wallet` Parameters: -| Flag | Type | Required | Description | -|:---------------------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| did_type | STRING | True | Must be either `new` or `recovery`. Must be either `new` or `recovery`. If `recovery`, then each of the following parameters will be ignored | -| backup_dids | STRING ARRAY | True\* | \*Required if `did_type` is `new`. An array of backup DID IDs to be used for recovery. Must match actual DIDs | -| num_of_backup_ids_needed | NUMBER | True\* | \*Required if `did_type` is `new`. The number of backup DIDs required for recovery. Minimum value is `1`, maximum value is the number of DIDs in `backup_dids` | -| metadata | DICT | False | The metadata of the DID | -| wallet_name | STRING | False | The name of the DID wallet [Default: None] | -| amount | NUMBER | True\* | \*Required if `did_type` is `new`. Specify the initial value of this wallet, in mojos. Minimum value is `1` | +| Flag | Type | Required | Description | +| :----------------------- | :----------- | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| did_type | STRING | True | Must be either `new` or `recovery`. Must be either `new` or `recovery`. If `recovery`, then each of the following parameters will be ignored | +| backup_dids | STRING ARRAY | True\* | \*Required if `did_type` is `new`. An array of backup DID IDs to be used for recovery. Must match actual DIDs | +| num_of_backup_ids_needed | NUMBER | True\* | \*Required if `did_type` is `new`. The number of backup DIDs required for recovery. Minimum value is `1`, maximum value is the number of DIDs in `backup_dids` | +| metadata | DICT | False | The metadata of the DID | +| wallet_name | STRING | False | The name of the DID wallet [Default: None] | +| amount | NUMBER | True\* | \*Required if `did_type` is `new`. Specify the initial value of this wallet, in mojos. Minimum value is `1` | Note: Because `backup_dids` is required, you must already have access to a DID in order to run this RPC for a did_wallet. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. If you do not already have a DID, then run [the CLI command](/did-cli#create) to create a DID wallet instead. @@ -952,16 +952,16 @@ Profile 1: `dao_wallet` Parameters: -| Flag | Type | Required | Description | -|:---------------- |:--------- |:--------- |:---------------------------------------------------------------------------------------------------------------------------- | -| mode | STRING | True | Must be either `new` of `existing` | -| name | STRING | False | A name to give to the DAO new/existing wallet [Default: None] | -| dao_rules | JSON DICT | True\* | \*Required if `mode` is `new`; this is a json dictionary of the new DAO's rules | -| amount_of_cats | NUMBER | False\* | \*Only used if `mode` is `new`; this is the number of DAO CATs (in mojos) to create when initializing the DAO [Default: 0] | -| filter-amount | NUMBER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | -| fee | NUMBER | False\* | \*Required if `mode` is `new`. This is the puzzle hash to which payouts will go | -| fee_for_cat | NUMBER | False\* | \*Only used if `mode` is `new`; this is a blockchain fee to add to the transaction to create the DAO CATs [Default: 0] | -| treasury_id | STRING | True\* | \*Required if `mode` is `existing`. \*Required if `mode` is `existing`. Specify the `asset_id` of the wallet to update | +| Flag | Type | Required | Description | +| :------------- | :-------- | :------- | :------------------------------------------------------------------------------------------------------------------------- | +| mode | STRING | True | Must be either `new` of `existing` | +| name | STRING | False | A name to give to the DAO new/existing wallet [Default: None] | +| dao_rules | JSON DICT | True\* | \*Required if `mode` is `new`; this is a json dictionary of the new DAO's rules | +| amount_of_cats | NUMBER | False\* | \*Only used if `mode` is `new`; this is the number of DAO CATs (in mojos) to create when initializing the DAO [Default: 0] | +| filter-amount | NUMBER | False | The minimum number of votes a proposal needs before the wallet will recognise it \[default: 1] | +| fee | NUMBER | False\* | \*Required if `mode` is `new`. This is the puzzle hash to which payouts will go | +| fee_for_cat | NUMBER | False\* | \*Only used if `mode` is `new`; this is a blockchain fee to add to the transaction to create the DAO CATs [Default: 0] | +| treasury_id | STRING | True\* | \*Required if `mode` is `existing`. \*Required if `mode` is `existing`. Specify the `asset_id` of the wallet to update | Notes: @@ -1019,7 +1019,7 @@ Your wallet will join the treasury and automatically create the required DAO, CA `nft_wallet` Parameters: | Flag | Type | Required | Description | -|:------ |:------ |:-------- |:------------------------------------------------------------------ | +| :----- | :----- | :------- | :----------------------------------------------------------------- | | did_id | STRING | False | Associate a DID with the new NFT wallet | | name | STRING | False | The name of the wallet to create or modify [Default: `NFT Wallet`] | @@ -1080,11 +1080,11 @@ Response: `pool_wallet` Parameters: -| Flag | Type | Required | Description | -|:------------------------- |:------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| mode | STRING | True | Must be either `new` of `recovery`. Must be either `new` of `recovery`. However, `recovery` has not been implemented, so currently (version 1.6) it will automatically fail | +| Flag | Type | Required | Description | +| :---------------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| mode | STRING | True | Must be either `new` of `recovery`. Must be either `new` of `recovery`. However, `recovery` has not been implemented, so currently (version 1.6) it will automatically fail | | initial_target_state | STRING | True | This info should be sent from the daemon. This info should be sent from the daemon. `PoolState` is a type that is serialized to the blockchain to track the state of the user's pool singleton `target_puzzle_hash` is either the pool address, or the self-pooling address that pool rewards will be paid to. `target_puzzle_hash` is NOT the `p2_singleton` puzzle that block rewards are sent to. The `p2_singleton` address is the initial address, and the `target_puzzle_hash` is the final destination. `relative_lock_height` is zero when in `SELF_POOLING` state `target_puzzle_hash` is NOT the `p2_singleton` puzzle that block rewards are sent to. The `p2_singleton` address is the initial address, and the `target_puzzle_hash` is the final destination. `relative_lock_height` is zero when in `SELF_POOLING` state | -| p2_singleton_delayed_ph | STRING | True\* | \*Required if `mode` is `new`. This is the puzzle hash to which payouts will go | +| p2_singleton_delayed_ph | STRING | True\* | \*Required if `mode` is `new`. This is the puzzle hash to which payouts will go | | p2_singleton_delay_time | INTEGER | False | The time (in seconds) to delay payments [Default: None ] | --- @@ -1098,34 +1098,34 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------ |:------- |:-------- |:------------------------------------------------------------------------ | +| :----------- | :------ | :------- | :----------------------------------------------------------------------- | | include_data | BOOLEAN | False | Set to `true` to include all coin info for this wallet [Default: `true`] | | type | INTEGER | False | The type of wallet to retrieve. See below for valid types | Valid wallet types (the `type` parameter) include the following integers: -| Name | type | -|:------------------ | ----:| -| STANDARD_WALLET | 0 | -| ATOMIC_SWAP | 2 | -| AUTHORIZED_PAYEE | 3 | -| MULTI_SIG | 4 | -| CUSTODY | 5 | -| CAT | 6 | -| RECOVERABLE | 7 | -| DECENTRALIZED_ID | 8 | -| POOLING_WALLET | 9 | -| NFT | 10 | -| DATA_LAYER | 11 | +| Name | type | +| :--------------- | ---: | +| STANDARD_WALLET | 0 | +| ATOMIC_SWAP | 2 | +| AUTHORIZED_PAYEE | 3 | +| MULTI_SIG | 4 | +| CUSTODY | 5 | +| CAT | 6 | +| RECOVERABLE | 7 | +| DECENTRALIZED_ID | 8 | +| POOLING_WALLET | 9 | +| NFT | 10 | +| DATA_LAYER | 11 | | DATA_LAYER_OFFER | 12 | -| VC | 13 | +| VC | 13 | More types may be added in the future. More types may be added in the future. See [wallet_types.py](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/wallet/util/wallet_types.py) for an up-to-date list of valid types. @@ -1204,24 +1204,24 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------------------- |:------------ |:-------- |:------------------------------------------------------------------------------------------ | -| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | -| additions | TEXT ARRAY | True | A list of puzzle hashes and amounts to be included | +| Flag | Type | Required | Description | +| :------------------- | :----------- | :------- | :----------------------------------------------------------------------------------------- | +| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | +| additions | TEXT ARRAY | True | A list of puzzle hashes and amounts to be included | | min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | | max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | | exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| coins | TEXT ARRAY | True | A list of coins to include | -| exclude_coins | TEXT ARRAY | True | A list of coins to exclude | -| coin_announcements | TEXT ARRAY | False | A list of coin announcements, which includes `coin_id`, `message`, and `morph_bytes` | -| puzzle_announcements | TEXT ARRAY | False | A list of puzzle announcements, which includes `puzzle_hash`, `message`, and `morph_bytes` | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| coins | TEXT ARRAY | True | A list of coins to include | +| exclude_coins | TEXT ARRAY | True | A list of coins to exclude | +| coin_announcements | TEXT ARRAY | False | A list of coin announcements, which includes `coin_id`, `message`, and `morph_bytes` | +| puzzle_announcements | TEXT ARRAY | False | A list of puzzle announcements, which includes `puzzle_hash`, `message`, and `morph_bytes` | +| fee | NUMBER | False | An optional blockchain fee, in mojos | --- @@ -1234,14 +1234,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:-------------------------------------------------------------------------------------------------------------------------- | +| :-------- | :------- | :------------------------------------------------------------------------------------------------------------------------- | | ids | False | Set to delete notifications only from the specified IDs. \[Default: delete from all IDs\] \[Default: delete from all IDs\] |
@@ -1272,14 +1272,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------ | +| :-------- | :----- | :------- | :----------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet from which to delete transactions |
@@ -1310,14 +1310,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:------ |:-------- |:------------------------------------------------------------------------------------------ | +| :---- | :----- | :------- | :----------------------------------------------------------------------------------------- | | index | NUMBER | True | The new derivation index. The new derivation index. Must be larger than the previous index | Note: The derivation index is the minimum number of addresses the wallet will examine. It's not possible to decrease this number. It's not possible to decrease this number. @@ -1351,7 +1351,7 @@ Usage: chia rpc wallet [OPTIONS] get_coin_records [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1405,17 +1405,17 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:--------------------- |:---------- |:-------- |:--------------------------------------------------- | -| names | TEXT ARRAY | True | A list of coin names from which to retrieve records | -| start_height | NUMBER | False | The block height at which to start the query | -| end_height | NUMBER | False | The block height at which to end the query | +| Flag | Type | Required | Description | +| :------------------ | :--------- | :------- | :-------------------------------------------------- | +| names | TEXT ARRAY | True | A list of coin names from which to retrieve records | +| start_height | NUMBER | False | The block height at which to start the query | +| end_height | NUMBER | False | The block height at which to end the query | | include_spent_coins | BOOLEAN | False | Include spent coins in the result [Default: false] |
@@ -1459,7 +1459,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1494,7 +1494,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -1533,14 +1533,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------- |:-------- |:------------------------------------------------------------------------------ | +| :---------- | :------ | :------- | :----------------------------------------------------------------------------- | | wallet_id | TEXT | True | The ID of the wallet from which to obtain the next address | | new_address | BOOLEAN | True | If `true`, then create a new address, else display the latest existing address | @@ -1574,14 +1574,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | Required | Description | -|:--------- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------- | +| :-------- | :------- | :---------------------------------------------------------------------------------------------------------------------------------- | | ids | False | Set to receive notifications only from the specified IDs. \[Default: receive from all IDs\] \[Default: receive from all IDs\] | | start | False | The number corresponding to the first notification to list. \[Default: the first notification\] \[Default: the first notification\] | | end | False | The number corresponding to the last notification to list. \[Default: the last notification\] \[Default: the last notification\] | @@ -1623,19 +1623,19 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:----------------------- |:------------ |:-------- |:-------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the wallet from which to display coins | +| Flag | Type | Required | Description | +| :-------------------- | :----------- | :------- | :------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the wallet from which to display coins | | min_coin_amount | NUMBER | False | The smallest coin to be selected in this query [Default: No minimum] | | max_coin_amount | NUMBER | False | The largest coin to be selected in this query [Default: No maximum] | | excluded_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| excluded_coins | TEXT ARRAY | False | A list of coins to exclude | +| excluded_coins | TEXT ARRAY | False | A list of coins to exclude | | excluded_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude |
@@ -1683,14 +1683,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------------- |:---- |:-------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------------- | :--- | :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | transaction_id | TEXT | True | The ID of the transaction to obtain. The ID of the transaction to obtain. This is listed as `name` in the output of the [get_transactions](#get_transactions) RPC |
@@ -1766,14 +1766,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---------- |:------- |:-------- |:------------------------------------------------------------------- | +| :--------- | :------ | :------- | :------------------------------------------------------------------ | | wallet_id | NUMBER | True | The Wallet ID of the wallet from which to obtain transactions | | start | NUMBER | False | The sequence number of the first transaction to show [Default: 0] | | end | NUMBER | False | The sequence number of the last transaction to show [Default: 50] | @@ -2032,14 +2032,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:---- |:-------- |:-------------------------------------------------------- | +| :-------- | :--- | :------- | :------------------------------------------------------- | | wallet_id | TEXT | True | The wallet ID from which to obtain the transaction count |
@@ -2072,14 +2072,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -|:-------------- |:------ |:-------- |:-------------------------------------------------------- | +| :------------- | :----- | :------- | :------------------------------------------------------- | | transaction_id | STRING | True | The ID of the transaction for which to retrieve the memo |
@@ -2115,14 +2115,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------------ | +| :-------- | :----- | :------- | :----------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID of the wallet from which to obtain the balance |
@@ -2165,14 +2165,14 @@ Functionality: Obtain the balance (and related info) from one or more wallets Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---------- |:---- |:-------- |:------------------------------------------------------------------------------------------ | +| :--------- | :--- | :------- | :----------------------------------------------------------------------------------------- | | wallet_ids | LIST | False | A list of Wallet IDs from which to obtain the balance [Default: list info for all wallets] |
@@ -2231,20 +2231,20 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:----------------------- |:------------ |:-------- |:-------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The ID of the wallet from which to select coins | -| amount | NUMBER | True | The number of mojos to select | +| Flag | Type | Required | Description | +| :-------------------- | :----------- | :------- | :------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The ID of the wallet from which to select coins | +| amount | NUMBER | True | The number of mojos to select | | min_coin_amount | NUMBER | False | The smallest coin to be selected in this query [Default: No minimum] | | max_coin_amount | NUMBER | False | The largest coin to be selected in this query [Default: No maximum] | | excluded_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| excluded_coins | TEXT ARRAY | False | A list of coins to exclude | +| excluded_coins | TEXT ARRAY | False | A list of coins to exclude |
Example 1 @@ -2300,14 +2300,14 @@ Request failed: {'error': 'Transaction for 1000 is greater than spendable balanc Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -|:--------- |:---------- |:-------- |:--------------------------------------------------- | +| :-------- | :--------- | :------- | :-------------------------------------------------- | | target | HEX STRING | True | The puzzle hash you would like to send a message to | | message | HEX STRING | True | The hex-encoded message you would like to send | | amount | NUMBER | True | The number of mojos to include with this message | @@ -2599,24 +2599,24 @@ This command will create a Message Coin on the blockchain. This command will cre Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------------------- |:------------ |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | -| address | TEXT | True | The destination address | -| amount | NUMBER | True | The number of mojos to send | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | +| Flag | Type | Required | Description | +| :------------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | +| address | TEXT | True | The destination address | +| amount | NUMBER | True | The number of mojos to send | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | | min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | | max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | | exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | | exclude_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -2698,14 +2698,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:---------- |:-------- |:---------------------------------------------------------- | +| :-------- | :--------- | :------- | :--------------------------------------------------------- | | wallet_id | TEXT | True | The wallet ID for the origin of the transaction | | address | TEXT | True | The destination address | | amount | NUMBER | True | The number of mojos to send | @@ -2724,14 +2724,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -|:--------- |:------ |:-------- |:----------------------------------------------------------------------------------------------------- | +| :-------- | :----- | :------- | :---------------------------------------------------------------------------------------------------- | | address | STRING | True | The address to use for signing. The address to use for signing. Must possess the key for this address | | message | STRING | True | The message to include with the signature | @@ -2765,14 +2765,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Parameter | TYPE | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------------------------------------------------------- | +| :-------- | :----- | :------- | :------------------------------------------------------------------------------------------------------ | | id | STRING | True | The DID or NFT ID to use for signing. Must possess the key for this ID Must possess the key for this ID | | message | STRING | True | The message to include with the signature | @@ -2806,17 +2806,17 @@ Usage: chia rpc wallet [OPTIONS] spend_clawback_coins [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:---- |:-------- |:------------------------------------------------------------------- | +| :------------ | :----------- | :--- | :------- | :------------------------------------------------------------------ | | -j | --json-file | TEXT | False | Instead of REQUEST, provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------- |:------------ |:-------- |:-------------------------------------------------------------------------------------------------------------------- | -| coin_ids | STRING ARRAY | True | List of coin IDs to be spent | +| Flag | Type | Required | Description | +| :--------- | :----------- | :------- | :----------------------------------------------------------------------------------------------------------------- | +| coin_ids | STRING ARRAY | True | List of coin IDs to be spent | | batch_size | NUMBER | False | The number of coins to spend per bundle, [Default: `batch_size` obtainable from [get_auto_claim](#get_auto_claim)] | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos | When examining the on-chain metadata for a transaction, a coin with `"type": 6` is a clawback coin to be received by this wallet, and a coin with `"type": 7` is a clawback coin sent from this wallet. @@ -3062,19 +3062,19 @@ chia rpc wallet get_transaction '{"transaction_id": "66f7fd75bb4a2408d219d89f858 Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------ |:---- |:-------- |:--------------------------------------------------------------------------------------------------- | +| Flag | Type | Required | Description | +| :----------- | :--- | :------- | :------------------------------------------------------------------------------------------------ | | signing_mode | TEXT | False | Specify the type of signature to verify \[Default: BLS with hex input\] (see below for more info) | -| pubkey | TEXT | True | The public key of the signature to verify | -| message | TEXT | True | The message to verify | -| signature | TEXT | True | The signature to verify | -| address | TEXT | True | The address, which must be derived from `pubkey` | +| pubkey | TEXT | True | The public key of the signature to verify | +| message | TEXT | True | The message to verify | +| signature | TEXT | True | The signature to verify | +| address | TEXT | True | The address, which must be derived from `pubkey` | The signing mode strings are [stored in an enum](https://github.com/Chia-Network/chia-blockchain/blob/main/chia/types/signing_mode.py). As of Chia 2.0.0, valid signing mode strings include: As of Chia 2.0.0, valid signing mode strings include: @@ -3105,14 +3105,14 @@ Usage: chia rpc wallet [OPTIONS] cancel_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | secure | BOOLEAN | True | Set to `true` to cancel on the blockchain by spending the coin(s) being offered; set to `false` to cancel in the wallet only. If `false`, the offer could still be taken if it has been shared If `false`, the offer could still be taken if it has been shared | | trade_id | TEXT | True | The ID of the offer to cancel | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -3145,14 +3145,14 @@ Usage: chia rpc wallet [OPTIONS] cancel_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---------- |:------- |:-------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :--------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | secure | BOOLEAN | True | Set to `true` to cancel on the blockchain by spending the coin(s) being offered; set to `false` to cancel in the wallet only. If `false`, the offer could still be taken if it has been shared If `false`, the offer could still be taken if it has been shared | | batch_fee | NUMBER | False | The fee, in mojos, to add to each batch cancellation [Default: 0] | | batch_size | NUMBER | False | The number of offers to cancel in each batch [Default: 5] | @@ -3187,14 +3187,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:---- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| :------- | :--- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | asset_id | TEXT | True | The ID of the CAT whose name you would like to retrieve. The ID of the CAT whose name you would like to retrieve. This CAT must be listed in your `DEFAULT_CATS`, ie the CATs your wallet recognizes |
@@ -3227,14 +3227,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------------ | +| :-------- | :----- | :------- | :----------------------------------------------------------- | | wallet_id | NUMBER | True | The wallet ID of the CAT whose ID you would like to retrieve |
@@ -3267,14 +3267,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:-------------------------------------------------------------- | +| :-------- | :----- | :------- | :------------------------------------------------------------- | | wallet_id | NUMBER | True | The wallet ID of the CAT whose name you would like to retrieve |
@@ -3307,14 +3307,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:-------------------------------------------------------- | +| :-------- | :----- | :------- | :------------------------------------------------------- | | wallet_id | NUMBER | True | The ID of the wallet whose name you would like to change | | name | TEXT | True | The new name for the wallet | @@ -3347,29 +3347,29 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------------------- |:------------ |:--------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | -| additions | TEXT ARRAY | True\* | \*Must include either `additions` or `amount`. A list of puzzle hashes and amounts to be included | -| amount | NUMBER | True\* | \*Must include either `additions` or `amount`. The number of mojos to send | -| inner_address | TEXT | True | The destination address | -| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | -| coins | TEXT ARRAY | False | A list of coins to include in the spend | -| min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | -| max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | -| exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | -| exclude_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| extra_delta | TEXT | False\* | The CAT's `extra_delta` parameter; \*If specified, then `tail_reveal` and `tail_solution` must also be specified | -| tail_reveal | TEXT | False\* | The CAT's `tail_reveal` parameter; \*If specified, then `extra_delta` and `tail_solution` must also be specified | -| tail_solution | TEXT | False\* | The CAT's `tail_solution` parameter; \*If specified, then `extra_delta` and `tail_reveal` must also be specified | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| Flag | Type | Required | Description | +| :------------------- | :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wallet_id | TEXT | True | The wallet ID for the origin of the transaction | +| additions | TEXT ARRAY | True\* | \*Must include either `additions` or `amount`. A list of puzzle hashes and amounts to be included | +| amount | NUMBER | True\* | \*Must include either `additions` or `amount`. The number of mojos to send | +| inner_address | TEXT | True | The destination address | +| memos | TEXT ARRAY | False | An optional array of memos to be sent with the transaction | +| coins | TEXT ARRAY | False | A list of coins to include in the spend | +| min_coin_amount | NUMBER | False | The minimum coin amount to send [Default: 0] | +| max_coin_amount | NUMBER | False | The maximum coin amount to send [Default: 0] | +| exclude_coin_amounts | NUMBER ARRAY | False | A list of coin amounts to exclude | +| exclude_coin_ids | TEXT ARRAY | False | A list of coin IDs to exclude | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| extra_delta | TEXT | False\* | The CAT's `extra_delta` parameter; \*If specified, then `tail_reveal` and `tail_solution` must also be specified | +| tail_reveal | TEXT | False\* | The CAT's `tail_reveal` parameter; \*If specified, then `extra_delta` and `tail_solution` must also be specified | +| tail_solution | TEXT | False\* | The CAT's `tail_solution` parameter; \*If specified, then `extra_delta` and `tail_reveal` must also be specified | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -3470,14 +3470,14 @@ Usage: chia rpc wallet [OPTIONS] check_offer_validity [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----- |:---- |:-------- |:---------------------------------- | +| :---- | :--- | :------- | :--------------------------------- | | offer | TEXT | True | The contents of the offer to check |
@@ -3509,22 +3509,22 @@ Usage: chia rpc wallet [OPTIONS] create_offer_for_ids [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| offer | TEXT | True | The offer to create | -| validate_only | BOOLEAN | False | Only validate the offer instead of creating it [Default: false] | -| driver_dict | DICT | True | A dictionary of keys and values associated with the offer | +| Flag | Type | Required | Description | +| :-------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| offer | TEXT | True | The offer to create | +| validate_only | BOOLEAN | False | Only validate the offer instead of creating it [Default: false] | +| driver_dict | DICT | True | A dictionary of keys and values associated with the offer | | min_coin_amount | NUMBER | False | The minimum coin amount to select for the offer [Default: none] | | max_coin_amount | NUMBER | False | The maximum coin amount to select for the offer [Default: none] | -| solver | TEXT | False | A marshalled solver | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| solver | TEXT | False | A marshalled solver | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | --- @@ -3537,22 +3537,22 @@ Usage: chia rpc wallet [OPTIONS] get_all_offers [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------------------- |:------- |:-------- |:----------------------------------------------------------------------------- | -| start | NUMBER | False | The sequence number of the first offer to show [Default: 0] | -| end | NUMBER | False | The sequence number of the last offer to show [Default: 10] | +| Flag | Type | Required | Description | +| :------------------- | :------ | :------- | :---------------------------------------------------------------------------- | +| start | NUMBER | False | The sequence number of the first offer to show [Default: 0] | +| end | NUMBER | False | The sequence number of the last offer to show [Default: 10] | | exclude_my_offers | BOOLEAN | False | Set to `true` to exclude offers you originated [Default: false] | | exclude_taken_offers | BOOLEAN | False | Set to `true` to exclude offers that have already been taken [Default: false] | -| include_completed | BOOLEAN | False | Set to `true` to include offers that have been taken [Default: false] | -| sort_key | NUMBER | False | Specify the key for sorting [Default: None] | -| reverse | BOOLEAN | False | Set to `true` to sort the results in reverse order [Default: false] | -| file_contents | BOOLEAN | False | Set to `true` to display the contents of each offer [Default: false] | +| include_completed | BOOLEAN | False | Set to `true` to include offers that have been taken [Default: false] | +| sort_key | NUMBER | False | Specify the key for sorting [Default: None] | +| reverse | BOOLEAN | False | Set to `true` to sort the results in reverse order [Default: false] | +| file_contents | BOOLEAN | False | Set to `true` to display the contents of each offer [Default: false] |
Example @@ -3621,7 +3621,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -3679,14 +3679,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------------- |:---- |:-------- |:-------------------------------------------------------------------------------------------------------------------------------- | +| :------------ | :--- | :------- | :------------------------------------------------------------------------------------------------------------------------------- | | trade_id | TEXT | True | The offer's ID | | file_contents | TEXT | False | The contents of the offer. The contents of the offer. Required if the offer's info is not stored in the database for this wallet | @@ -3761,7 +3761,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -3798,14 +3798,14 @@ Usage: chia rpc wallet [OPTIONS] get_offer_summary [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------- |:------- |:-------- |:----------------------------------------------------------- | +| :------- | :------ | :------- | :---------------------------------------------------------- | | offer | TEXT | True | The offer for which to retrieve a summary | | advanced | BOOLEAN | False | Set to `true` to show a detailed summary [Default: `false`] | @@ -3852,7 +3852,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -3887,20 +3887,20 @@ Usage: chia rpc wallet [OPTIONS] take_offer [REQUEST] Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:----------------- |:------- |:-------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| offer | TEXT | True | The offer to create | +| Flag | Type | Required | Description | +| :-------------- | :------ | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| offer | TEXT | True | The offer to create | | min_coin_amount | NUMBER | False | The minimum coin amount to select for taking the offer [Default: none] | | max_coin_amount | NUMBER | False | The maximum coin amount to select for taking the offer [Default: none] | -| solver | TEXT | False | A marshalled solver | -| fee | NUMBER | False | An optional blockchain fee, in mojos | -| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml | +| solver | TEXT | False | A marshalled solver | +| fee | NUMBER | False | An optional blockchain fee, in mojos | +| reuse_puzhash | BOOLEAN | False | If `true`, will not generate a new puzzle hash / address for this transaction only. Note that setting this parameter to `true` will override the global default setting from config.yaml |
Example @@ -3995,17 +3995,17 @@ See our [NFT RPC](/nft-rpc) page. Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:------------------ |:------ |:-------- |:--------------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The Wallet ID to which to absorb funds (must be of type `POOLING_WALLET`) | +| Flag | Type | Required | Description | +| :--------------- | :----- | :------- | :-------------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The Wallet ID to which to absorb funds (must be of type `POOLING_WALLET`) | | max_spends_in_tx | NUMBER | False | The maximum number of reward transactions to roll into the absorb transaction [Default: no maximum] | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos | :::note @@ -4024,19 +4024,19 @@ This RPC will only succeed if the wallet has accumulated unspent coinbase reward Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: -| Flag | Type | Required | Description | -|:---------------------- |:------ |:-------- |:---------------------------------------------------------------------------------------------- | -| wallet_id | NUMBER | True | The Wallet ID to use to join the pool (must be of type `POOLING_WALLET`) | -| target_puzzlehash | TEXT | True | This is the target of where rewards will be sent to from the singleton. Controlled by the pool | -| pool_url | TEXT | True | The URL of the pool to join | +| Flag | Type | Required | Description | +| :------------------- | :----- | :------- | :--------------------------------------------------------------------------------------------- | +| wallet_id | NUMBER | True | The Wallet ID to use to join the pool (must be of type `POOLING_WALLET`) | +| target_puzzlehash | TEXT | True | This is the target of where rewards will be sent to from the singleton. Controlled by the pool | +| pool_url | TEXT | True | The URL of the pool to join | | relative_lock_height | NUMBER | True | The number of blocks required to wait when attempting to leave the pool | -| fee | NUMBER | False | An optional blockchain fee, in mojos | +| fee | NUMBER | False | An optional blockchain fee, in mojos |
Example @@ -4174,14 +4174,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------------------------ | +| :-------- | :----- | :------- | :----------------------------------------------------------------------- | | wallet_id | NUMBER | True | The Wallet ID to use for self-pooling (must be of type `POOLING_WALLET`) | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -4327,14 +4327,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:--------- |:------ |:-------- |:------------------------------------------------------------------------------- | +| :-------- | :----- | :------- | :------------------------------------------------------------------------------ | | wallet_id | NUMBER | True | The Wallet ID for which to obtain the status (must be of type `POOLING_WALLET`) |
@@ -4389,14 +4389,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:---- |:------ |:-------- |:--------------------------------------- | +| :--- | :----- | :------- | :-------------------------------------- | | root | TEXT | True | The root hash of an existing data store | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -4541,14 +4541,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:------ |:-------- |:------------------------------------- | +| :------ | :----- | :------- | :------------------------------------ | | coin_id | TEXT | True | The `coin_id` of the mirror to delete | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -4626,14 +4626,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:---- |:-------- |:--------------------------------------- | +| :---------- | :--- | :------- | :-------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet |
@@ -4673,14 +4673,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------------- |:------ |:-------- |:------------------------------------------------------------ | +| :------------- | :----- | :------- | :----------------------------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | min_generation | NUMBER | False | The first generation of singleton to show [Default: none] | | max_generation | NUMBER | False | The last generation of the singleton to show [Default: none] | @@ -4747,14 +4747,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:-------------- |:------- |:-------- |:------------------------------------------------------ | +| :------------- | :------ | :------- | :----------------------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | only_confirmed | BOOLEAN | False | Only show the latest confirmed record [Default: false] | @@ -4801,14 +4801,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:---------- |:-------- |:------------------------------------------------------------------------------------------------------------------------------- | +| :---------- | :--------- | :------- | :------------------------------------------------------------------------------------------------------------------------------ | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | urls | TEXT ARRAY | True | A list of URLs to be used for the mirror | | amount | NUMBER | True | The value of the mirror (in mojos) to spend to create the mirror. In theory, mirrors with a higher `amount` will be prioritized | @@ -4895,7 +4895,7 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | @@ -4962,14 +4962,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:---- |:-------- |:--------------------------------------- | +| :---------- | :--- | :------- | :-------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | root | TEXT | True | The root hash of an existing data store | @@ -5018,14 +5018,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:---- |:-------- |:--------------------------------------- | +| :---------- | :--- | :------- | :-------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet |
@@ -5056,14 +5056,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:---- |:-------- |:--------------------------------------- | +| :---------- | :--- | :------- | :-------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet |
@@ -5094,14 +5094,14 @@ Response: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:------- |:---------- |:-------- |:------------------------------------------- | +| :------ | :--------- | :------- | :------------------------------------------ | | updates | TEXT ARRAY | True | A list of launcher IDs and hashes to update | --- @@ -5115,14 +5115,14 @@ Request Parameters: Options: | Short Command | Long Command | Type | Required | Description | -|:------------- |:------------ |:-------- |:-------- |:------------------------------------------------------------------------------------- | +| :------------ | :----------- | :------- | :------- | :------------------------------------------------------------------------------------ | | -j | --json-file | FILENAME | False | Optionally instead of REQUEST you can provide a json file containing the request data | | -h | --help | None | False | Show a help message and exit | Request Parameters: | Flag | Type | Required | Description | -|:----------- |:------ |:-------- |:--------------------------------------- | +| :---------- | :----- | :------- | :-------------------------------------- | | launcher_id | TEXT | True | The launcher ID of the DataLayer wallet | | new_root | TEXT | True | The new root hash of the data store | | fee | NUMBER | False | An optional blockchain fee, in mojos | @@ -5212,7 +5212,7 @@ Note: Inherited from RPC Server Request Parameters: | Flag | Type | Required | Description | -|:------- |:---- |:-------- |:---------------------------------------------------------------- | +| :------ | :--- | :------- | :--------------------------------------------------------------- | | node_id | TEXT | True | The hex ID of the node to close, obtainable from get_connections |
@@ -5435,7 +5435,7 @@ Note: Inherited from RPC Server Request Parameters: | Flag | Type | Required | Description | -|:---- |:------- |:-------- |:---------------------------------------------------- | +| :--- | :------ | :------- | :--------------------------------------------------- | | host | TEXT | True | The IP or URL of the node to connect to | | port | INTEGER | True | The port through which to connect to the remote node | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md index ef0358a650..7df449d267 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/troubleshooting/logging-reference.md @@ -7,11 +7,11 @@ Chia blockchain nodes consist of several components that each handle different a ## Log file Location: -| OS | Location | -| ------- | ----------------------------------------------------------------------------------------------------------- | -| Linux | `~/.chia/mainnet/log/debug.log` | +| OS | Location | +| ------- | ---------------------------------------------------------------------------------- | +| Linux | `~/.chia/mainnet/log/debug.log` | | Windows | `%systemdrive% %homepath% \.chia\mainnet\debug.log` (`C:\Users\\.chia…`) | -| MacOS | `/Users//.chia/mainnet/log/debug.log` | +| MacOS | `/Users//.chia/mainnet/log/debug.log` | ## Log File Management: @@ -37,17 +37,17 @@ Change the `log_level` to `INFO`, save the file, and restart the node. ## Node Components: -| Component | Function | -| ---------------------------------------------------------- | ----------------------------------------------- | -| farmer_server | Signage stuff about signs and things | -| harvester_server | Gathers and shares plot information | -| timelord_server | Manages Verifiable Delay Functions for the node | -| wallet_server | Controls wallet functions | +| Component | Function | +| ---------------- | ----------------------------------------------- | +| farmer_server | Signage stuff about signs and things | +| harvester_server | Gathers and shares plot information | +| timelord_server | Manages Verifiable Delay Functions for the node | +| wallet_server | Controls wallet functions | | full_node_server | This component manages the node | ## Log Message Format: -| Field | 内容 | +| Field | 内容 | | ----------------- | -------------------------------- | | Date/time | in ISO format, in local timezone | | Node Component | see the list above | @@ -73,70 +73,70 @@ Another log message you will see is `Updated Wallet peak to height x, weight y` ## Other Normal Log Messages: -| Component | Message | Direction | Destination | Cross component | Comment | -| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | ----------------------------------------- | ------- | -| mempool_manager | add_spendbundle took x seconds | | | | | -| mempool_manager | It took x to pre validate transaction | | | | | -| full_node | Added unfinished_block x, not farmed by us | | | | | -| full_node | Already compactified block: | | | | | -| full_node | Duplicate compact proof. Height: x | | | | | -| full_node | Finished signage point x/64: | | | | | -| full_node | Scanning the blockchain for uncompact blocks. | | | | | -| full_node | Updated peak to height x | | | | | -| full_node_server | new_compact_vdf | to/from | peer | | | -| full_node_server | new_peak | to/from | peer | | | -| full_node_server | new_peak_timelord | to | localhost | from timelord_server | | -| full_node_server | new_peak_wallet | to | localhost | from wallet_server | | -| full_node_server | new_signage_point | to | localhost | from farmer_server | | -| full_node_server | new_signage_point_or_end_of_sub_slot | to/from | peer | | | -| full_node_server | new_transaction | to/from | peer | | | -| full_node_server | new_unfinished_block | to/from | peer | | | -| full_node_server | new_unfinished_block_timelord | to/from | localhost | | | -| full_node_server | request_block | to/from | peer | | | -| full_node_server | request_block_header | from | localhost | to wallet_server | | -| full_node_server | request_compact_vdf | to/from | peer | | | -| full_node_server | request_compact_proof_of_time | to | localhost | from timelord_server | | -| full_node_server | request_signage_point_or_end_of_sub_slot | to/from | peer | | | -| full_node_server | request_transaction | to/from | peer | | | -| full_node_server | request_unfinished_block | to/from | peer | | | -| full_node_server | respond_block | to/from | peer | | | -| full_node_server | respond_compact_vdf | to/from | peer | | | -| full_node_server | respond_signage_point | to/from | peer | | | -| full_node_server | respond_transaction | to/from | peer | | | -| full_node_server | respond_unfinished_block | to/from | peer | | | -| wallet_server | request_block_header | to | localhost | from full_node | | -| wallet_server | respond_block_header | from | localhost | to full_node | | -| wallet_server | new_peak_wallet | from | localhost | to full_node | | -| wallet_blockchain | Updated Wallet peak to height x, weight y | | | | | -| timelord_server | new_peak_timelord | from | localhost | to full_node | | -| timelord_server | new_unfinished_block_timelord | from | localhost | to full_node | | -| timelord_launcher | VDF client x: VDF Client: Discriminant = | | | | | -| VDF Client | Sending Proof, Sent Proof, Stopped everything! | | | | | -| harvester_server | farming_info | to/from | localhost | | | -| harvester_server | new_signage_point_harvester | from | localhost | to farmer_server | | -| harvester | x plots were eligible for farming | | | | | -| plot_tools | Loaded a total of x plots of size y in z seconds | | | | | -| plot_tools | Searching directories | | | | | -| farmer_server | new_signage_point | from | localhost | to full_node | | -| farmer_server | farming_info | from | localhost | to full_node | | -| farmer_server | new_signage_point_harvester | to | localhost | from harvester | | - -| Source | Level | Message | Description | -| -------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| daemon asyncio | ERROR | Task exception was never retrieved future: ` exception=ValueError('list.remove(x): x not in list')>` | | -| full_node asyncio | ERROR | SSL error in data received protocol: `` | | -| full_node full_node_server | ERROR | Exception: Failed to fetch block `N` from \{'host': `IP ADDRESS`, 'port': 8444\}, timed out, \{'host': `IP ADDRESS`, 'port': 8444\}. | Peer disconnected, other peer connections will take over | -| full_node full_node_server | ERROR | Exception: ``, closing connection None. | Peer disconnected | -| full_node full_node_server | WARNING | [Errno 32] Broken pipe `IP Address` | Peer disconnected | -| full_node full_node_server | WARNING | Cannot write to closing transport `IP Address` | Peer disconnected | -| harvester src.plotting.plot_tools | WARNING | Not farming plot `plotfilename`. Size is `filesize` GiB, but expected at least: 99.06 GiB. We assume the file is being copied. | Periodic scan for new plots have discovered partial file - OK if you are in the middle of copying a file | -| harvester src.plotting.plot_tools | WARNING | Directory: `Dir1` does not exist. | One of your monitored plot folders is no longer accessible - eg external drive offline - if permanent remove from GUI or `chia plots remove -d ` | -| harvester src.plotting.plot_tools | WARNING | Have multiple copies of the plot `plotfilename`, not adding it. | | -| harvester src.plotting.plot_tools | INFO | Not checking subdirectory `Dir1/directory`, subdirectories not added by default | | -| full_node full_node_server | INFO | Connection closed: `IP Address`, node id: `hex` | Peer disconnected | -| full_node src.full_node.full_node | INFO | ⏲️ Finished signage point `N`/64: `hex` | | -| full_node src.full_node.full_node | INFO | Added unfinished_block `hex`, not farmed | | -| harvester src.plotting.plot_tools | INFO | Searching directories [`Dir1`,`Dir2`] | | -| harvester src.plotting.plot_tools | INFO | Loaded a total of `N` plots of size `size` TiB, in `time` seconds | | -| harvester src.harvester.harvester | INFO | `X` plots were eligible for farming `hex`... Found `Y` proofs. Time: `Time` s. Total `Z` plots | This is a vital message and should be seen at regular intervals. Note that `Time` is ideally < 1s. If drive is in sleep mode, may show ~10 seconds, and should be prevented | -| wallet src.wallet.wallet_blockchain | INFO | 💰 Updated wallet peak to height `HEIGHT`, weight `WEIGHT`, | | +| Component | Message | Direction | Destination | Cross component | Comment | +| ----------------- | ------------------------------------------------ | --------- | ----------- | -------------------- | ------- | +| mempool_manager | add_spendbundle took x seconds | | | | | +| mempool_manager | It took x to pre validate transaction | | | | | +| full_node | Added unfinished_block x, not farmed by us | | | | | +| full_node | Already compactified block: | | | | | +| full_node | Duplicate compact proof. Height: x | | | | | +| full_node | Finished signage point x/64: | | | | | +| full_node | Scanning the blockchain for uncompact blocks. | | | | | +| full_node | Updated peak to height x | | | | | +| full_node_server | new_compact_vdf | to/from | peer | | | +| full_node_server | new_peak | to/from | peer | | | +| full_node_server | new_peak_timelord | to | localhost | from timelord_server | | +| full_node_server | new_peak_wallet | to | localhost | from wallet_server | | +| full_node_server | new_signage_point | to | localhost | from farmer_server | | +| full_node_server | new_signage_point_or_end_of_sub_slot | to/from | peer | | | +| full_node_server | new_transaction | to/from | peer | | | +| full_node_server | new_unfinished_block | to/from | peer | | | +| full_node_server | new_unfinished_block_timelord | to/from | localhost | | | +| full_node_server | request_block | to/from | peer | | | +| full_node_server | request_block_header | from | localhost | to wallet_server | | +| full_node_server | request_compact_vdf | to/from | peer | | | +| full_node_server | request_compact_proof_of_time | to | localhost | from timelord_server | | +| full_node_server | request_signage_point_or_end_of_sub_slot | to/from | peer | | | +| full_node_server | request_transaction | to/from | peer | | | +| full_node_server | request_unfinished_block | to/from | peer | | | +| full_node_server | respond_block | to/from | peer | | | +| full_node_server | respond_compact_vdf | to/from | peer | | | +| full_node_server | respond_signage_point | to/from | peer | | | +| full_node_server | respond_transaction | to/from | peer | | | +| full_node_server | respond_unfinished_block | to/from | peer | | | +| wallet_server | request_block_header | to | localhost | from full_node | | +| wallet_server | respond_block_header | from | localhost | to full_node | | +| wallet_server | new_peak_wallet | from | localhost | to full_node | | +| wallet_blockchain | Updated Wallet peak to height x, weight y | | | | | +| timelord_server | new_peak_timelord | from | localhost | to full_node | | +| timelord_server | new_unfinished_block_timelord | from | localhost | to full_node | | +| timelord_launcher | VDF client x: VDF Client: Discriminant = | | | | | +| VDF Client | Sending Proof, Sent Proof, Stopped everything! | | | | | +| harvester_server | farming_info | to/from | localhost | | | +| harvester_server | new_signage_point_harvester | from | localhost | to farmer_server | | +| harvester | x plots were eligible for farming | | | | | +| plot_tools | Loaded a total of x plots of size y in z seconds | | | | | +| plot_tools | Searching directories | | | | | +| farmer_server | new_signage_point | from | localhost | to full_node | | +| farmer_server | farming_info | from | localhost | to full_node | | +| farmer_server | new_signage_point_harvester | to | localhost | from harvester | | + +| Source | Level | Message | Description | +| ----------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| daemon asyncio | ERROR | Task exception was never retrieved future: ` exception=ValueError('list.remove(x): x not in list')>` | | +| full_node asyncio | ERROR | SSL error in data received protocol: `` | | +| full_node full_node_server | ERROR | Exception: Failed to fetch block `N` from \{'host': `IP ADDRESS`, 'port': 8444\}, timed out, \{'host': `IP ADDRESS`, 'port': 8444\}. | Peer disconnected, other peer connections will take over | +| full_node full_node_server | ERROR | Exception: ``, closing connection None. | Peer disconnected | +| full_node full_node_server | WARNING | [Errno 32] Broken pipe `IP Address` | Peer disconnected | +| full_node full_node_server | WARNING | Cannot write to closing transport `IP Address` | Peer disconnected | +| harvester src.plotting.plot_tools | WARNING | Not farming plot `plotfilename`. Size is `filesize` GiB, but expected at least: 99.06 GiB. We assume the file is being copied. | Periodic scan for new plots have discovered partial file - OK if you are in the middle of copying a file | +| harvester src.plotting.plot_tools | WARNING | Directory: `Dir1` does not exist. | One of your monitored plot folders is no longer accessible - eg external drive offline - if permanent remove from GUI or `chia plots remove -d ` | +| harvester src.plotting.plot_tools | WARNING | Have multiple copies of the plot `plotfilename`, not adding it. | | +| harvester src.plotting.plot_tools | INFO | Not checking subdirectory `Dir1/directory`, subdirectories not added by default | | +| full_node full_node_server | INFO | Connection closed: `IP Address`, node id: `hex` | Peer disconnected | +| full_node src.full_node.full_node | INFO | ⏲️ Finished signage point `N`/64: `hex` | | +| full_node src.full_node.full_node | INFO | Added unfinished_block `hex`, not farmed | | +| harvester src.plotting.plot_tools | INFO | Searching directories [`Dir1`,`Dir2`] | | +| harvester src.plotting.plot_tools | INFO | Loaded a total of `N` plots of size `size` TiB, in `time` seconds | | +| harvester src.harvester.harvester | INFO | `X` plots were eligible for farming `hex`... Found `Y` proofs. Time: `Time` s. Total `Z` plots | This is a vital message and should be seen at regular intervals. Note that `Time` is ideally < 1s. If drive is in sleep mode, may show ~10 seconds, and should be prevented | +| wallet src.wallet.wallet_blockchain | INFO | 💰 Updated wallet peak to height `HEIGHT`, weight `WEIGHT`, | | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md index 20dd3d20d9..7ed073feb5 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/general.md @@ -250,25 +250,25 @@ Gets the current sync status of the wallet. ### TransactionRecord -| Parameter | Type | Description | -| ------------------- | ------------------------------------------------------------ | -------------------------------------- | -| `confirmedAtHeight` | `number` | Block height the tx was confirmed. | -| `createdAtTime` | `number` | The timestamp when the tx was created. | -| `toPuzzleHash` | `string` | The destination puzzle hash. | -| `amount` | `number` | The amount sent in mojos. | -| `feeAmount` | `number` | The transaction fee in mojos. | -| `confirmed` | `boolean` | Whether the tx was confirmed. | -| `sent` | `number` | Number of peers the tx was sent to. | -| `sentTo` | [`Peer[]`](/walletconnect-commands#peer) | The peers the tx has been sent to. | -| `spendBundle` | [SpendBundle](/walletconnect-commands#spendbundle) | null | The associated spend bundle. | -| `additions` | [`Coin[]`](/walletconnect-commands#coin) | Created coins in the block. | -| `removals` | [`Coin[]`](/walletconnect-commands#coin) | Spent coins in the block. | -| `walletId` | `number` | The wallet id. | -| `toAddress` | `string` | The bech32m encoded `to_puzzle_hash`. | -| `trade_id` | string | null | | -| `type` | [`TransactionType`](/walletconnect-commands#transactiontype) | The type of transaction. | -| `name` | `string` | The transaction's id. | -| `memos` | `Memo[]` | The memos associated with the tx. | +| Parameter | Type | Description | +| ------------------- | --------------------------------------------------------------------------- | -------------------------------------- | +| `confirmedAtHeight` | `number` | Block height the tx was confirmed. | +| `createdAtTime` | `number` | The timestamp when the tx was created. | +| `toPuzzleHash` | `string` | The destination puzzle hash. | +| `amount` | `number` | The amount sent in mojos. | +| `feeAmount` | `number` | The transaction fee in mojos. | +| `confirmed` | `boolean` | Whether the tx was confirmed. | +| `sent` | `number` | Number of peers the tx was sent to. | +| `sentTo` | [`Peer[]`](/walletconnect-commands#peer) | The peers the tx has been sent to. | +| `spendBundle` | [SpendBundle](/walletconnect-commands#spendbundle) | null | The associated spend bundle. | +| `additions` | [`Coin[]`](/walletconnect-commands#coin) | Created coins in the block. | +| `removals` | [`Coin[]`](/walletconnect-commands#coin) | Spent coins in the block. | +| `walletId` | `number` | The wallet id. | +| `toAddress` | `string` | The bech32m encoded `to_puzzle_hash`. | +| `trade_id` | string | null | | +| `type` | [`TransactionType`](/walletconnect-commands#transactiontype) | The type of transaction. | +| `name` | `string` | The transaction's id. | +| `memos` | `Memo[]` | The memos associated with the tx. | ### TransactionType @@ -293,7 +293,7 @@ This is a tuple with the following parameters. | ---------------------------- | ------------------------------------------------------------ | -------------------------- | | `peerId` _(item 1)_ | `string` | Peer id. | | `inclusionStatus` _(item 2)_ | [`InclusionStatus`](/walletconnect-commands#inclusionstatus) | Inclusion status. | -| `errorMessage` _(item 3)_ | string | null | Error message, if present. | +| `errorMessage` _(item 3)_ | string | null | Error message, if present. | ### InclusionStatus diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md index a0f160a5ea..54a4832434 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/nfts.md @@ -34,17 +34,17 @@ The output is an object of type [`NftInfo`](#nftinfo). ### `chia_mintNFT` -| Parameter | Type | Description | -| -------------------------------- | ------------------------- | ------------------------------------- | -| `walletId` | `number` | NFT wallet id. | +| Parameter | Type | Description | +| -------------------------------- | ------------------------------- | ------------------------------------- | +| `walletId` | `number` | NFT wallet id. | | `royaltyAddress` _(optional)_ | string | null | Address royalty is sent to. | | `royaltyPercentage` _(optional)_ | number | null | Creator royalty percent. (1000 = 1%) | | `targetAddress` _(optional)_ | string | null | Address NFT is sent to upon mint. | -| `uris` | `string[]` | List of NFT content URIs. | -| `hash` | `string` | Hash of the NFT content. | -| `metaUris` | `string[]` | List of metadata URIs. | +| `uris` | `string[]` | List of NFT content URIs. | +| `hash` | `string` | Hash of the NFT content. | +| `metaUris` | `string[]` | List of metadata URIs. | | `metaHash` _(optional)_ | string | null | Hash of the metadata. | -| `licenseUris` | `string[]` | List of the license URIs. | +| `licenseUris` | `string[]` | List of the license URIs. | | `licenseHash` _(optional)_ | string | null | Hash of the license. | | `editionNumber` _(optional)_ | number | null | Number of the current NFT in edition. | | `editionTotal` _(optional)_ | number | null | How many NFTs in the current edition. | @@ -74,7 +74,7 @@ The output is an object of type [`NftInfo`](#nftinfo). | Parameter | Type | Description | | --------------------- | ---------------------------------------------------- | --------------------- | -| `walletId` | number | number[] | NFT wallet id(s). | +| `walletId` | number | number[] | NFT wallet id(s). | | `spendBundle` | [`SpendBundle`](/walletconnect-commands#spendbundle) | Created spend bundle. | | `txNum?` _(optional)_ | `number` | Transaction number. | @@ -116,32 +116,32 @@ Sets the owner DID associated with a given NFT. ### NFTInfo -| Parameter | Type | Description | -| --------------------------- | -------------------------- | -------------------------------------- | -| `nftId` | `string` | The NFT id. | -| `launcherId` | `string` | The launcher id. | -| `nftCoinId` | `string` | The current coin id. | -| `nftCoinConfirmationHeight` | `number` | Current NFT coin confirmation height | +| Parameter | Type | Description | +| --------------------------- | ------------------------------- | -------------------------------------- | +| `nftId` | `string` | The NFT id. | +| `launcherId` | `string` | The launcher id. | +| `nftCoinId` | `string` | The current coin id. | +| `nftCoinConfirmationHeight` | `number` | Current NFT coin confirmation height | | `ownerDid` | string | null | The owner DID. | | `royaltyPercentage` | number | null | Creator royalty percent. (1000 = 1%) | | `royaltyPuzzleHash` | string | null | Puzzle hash royalty is sent to. | -| `royaltyAddress` | `string` | Address royalty is sent to. | -| `targetAddress` | `string` | Address NFT is sent to upon mint. | -| `uris` | `string[]` | List of NFT content URIs. | -| `hash` | `string` | Hash of the NFT content. | -| `metaUris` | `string[]` | List of metadata URIs. | -| `metaHash` | `string` | Hash of the metadata. | -| `licenseUris` | `string[]` | List of the license URIs. | -| `licenseHash` | `string` | Hash of the license. | -| `editionTotal` | `number` | How many NFTs in the current edition. | -| `editionNumber` | `number` | Number of the current NFT in edition. | -| `updaterPuzhash` | `string` | Puzzle hash of the metadata updater. | -| `chainInfo` | `string` | Information saved on the chain. | -| `mintHeight` | `number` | Block height when the NFT was minted. | -| `supportsDid` | `boolean` | Whether the inner puzzle supports DID. | -| `p2Address` | `string` | The innermost puzzle hash of the NFT. | -| `pendingTransaction` | `boolean` | Whether the NFT is pending for a tx. | +| `royaltyAddress` | `string` | Address royalty is sent to. | +| `targetAddress` | `string` | Address NFT is sent to upon mint. | +| `uris` | `string[]` | List of NFT content URIs. | +| `hash` | `string` | Hash of the NFT content. | +| `metaUris` | `string[]` | List of metadata URIs. | +| `metaHash` | `string` | Hash of the metadata. | +| `licenseUris` | `string[]` | List of the license URIs. | +| `licenseHash` | `string` | Hash of the license. | +| `editionTotal` | `number` | How many NFTs in the current edition. | +| `editionNumber` | `number` | Number of the current NFT in edition. | +| `updaterPuzhash` | `string` | Puzzle hash of the metadata updater. | +| `chainInfo` | `string` | Information saved on the chain. | +| `mintHeight` | `number` | Block height when the NFT was minted. | +| `supportsDid` | `boolean` | Whether the inner puzzle supports DID. | +| `p2Address` | `string` | The innermost puzzle hash of the NFT. | +| `pendingTransaction` | `boolean` | Whether the NFT is pending for a tx. | | `didId` | string | null | The DID used during an NFT mint. | | `minterDid` | string | null | The minter DID. | -| `launcherPuzhash` | `string` | Singleton launcher puzzle hash. | +| `launcherPuzhash` | `string` | Singleton launcher puzzle hash. | | `offChainMetadata` | string | null | Serialized off-chain metadata. | diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md index 50a410aa13..016380576c 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/walletconnect/offers.md @@ -155,17 +155,17 @@ Creates an offer for wallet ids. | Parameter | Type | Description | | ------------------ | -------------------------------------------------- | -------------------------------------------- | -| `acceptedAtTime` | number | null | Timestamp when the trade was accepted. | +| `acceptedAtTime` | number | null | Timestamp when the trade was accepted. | | `coinsOfInterest` | [`Coin[]`](/walletconnect-commands#coin) | Coins involved in trade. | | `confirmedAtIndex` | `number` | Confirmation block index. | | `createdAtTime` | `number` | Timestamp when the trade was created. | | `isMyOffer` | `boolean` | Whether this is the wallet's own offer. | -| `pending` | `Record` | Pending amounts. | +| `pending` | `Record` | Pending amounts. | | `sent` | `number` | Number of peers the transaction was sent to. | | `sentTo` | [`Peer[]`](/walletconnect-commands#peer) | Peers the transaction was sent to. | | `status` | [`TradeStatus`](/walletconnect-offers#tradestatus) | Trade status. | | `summary` | `any` | Trade summary metadata. | -| `takenOffer` | string | null | Taken bech32m encoded offer data. | +| `takenOffer` | string | null | Taken bech32m encoded offer data. | | `tradeId` | `string` | Trade id. | | `_offerData` | `string` | Bech32m encoded offer data. |