From e94c534537071cc1ed0bc735e4eafeea25aa4c21 Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Fri, 26 Apr 2024 11:03:46 -0500 Subject: [PATCH 1/8] Update overview.mdx --- docs/developer-docs/smart-contracts/call/overview.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/developer-docs/smart-contracts/call/overview.mdx b/docs/developer-docs/smart-contracts/call/overview.mdx index 76024acfed..6c191f22b2 100644 --- a/docs/developer-docs/smart-contracts/call/overview.mdx +++ b/docs/developer-docs/smart-contracts/call/overview.mdx @@ -15,7 +15,7 @@ import { GlossaryTooltip } from "/src/components/Tooltip/GlossaryTooltip"; ## Introduction -To interact with a >canister's methods, there are two primary types of calls that can be used: update calls and query calls. +To interact with a canister's methods, there are two primary types of calls that can be used: update calls and query calls. Canisters implement methods that can be called via update or query calls. A query method can be called as both an update and a query, whereas update methods can be called only as an update. @@ -83,7 +83,7 @@ def set_message(new_message: str) -> void: Query calls, also referred to as non-replicated queries, are executed on a single node and return a synchronous response. Since they execute on a single node, they do not go through consensus and can be much faster than update calls. -:::warning +:::caution The downside of query calls is that the response is not trusted since it's coming from a single node. An update call or a certified query (see below) should be used for security-critical calls. ::: From dbee7997df9a25fa273968ae348e597445eb85d2 Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Fri, 26 Apr 2024 11:37:11 -0500 Subject: [PATCH 2/8] Update index.tsx --- src/components/Basics/Ecosystem/index.tsx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/components/Basics/Ecosystem/index.tsx b/src/components/Basics/Ecosystem/index.tsx index 6965ccff19..03a7a65d07 100644 --- a/src/components/Basics/Ecosystem/index.tsx +++ b/src/components/Basics/Ecosystem/index.tsx @@ -29,14 +29,14 @@ const cards = [ stats: "50,000+ users", }, { - logo: require("../../../../static/img/basics/bioniq-logo.webp").default, + logo: require("../../../../static/img/basics/bioniq-logo.jpeg").default, title: "Bioniq", oneLiner: "Buy, sell, and trade with no gas fees, near-instant finality, and decentralized secure token bridging", stats: "45,000+ users", }, { - logo: require("../../../../static/img/basics/helix-logo.webp").default, + logo: require("../../../../static/img/basics/helix_logo.webp").default, title: "Helix", oneLiner: "Decentralized exchange that aims to bring true ownership and full transparency to crypto trading.", stats: "2,000+ users", From 55b9ddcd5e96f0c212b029ac66f154f4971a1c12 Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Fri, 26 Apr 2024 12:04:36 -0500 Subject: [PATCH 3/8] Update 3.3-certified-data.mdx --- docs/tutorials/developer-journey/level-3/3.3-certified-data.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/developer-journey/level-3/3.3-certified-data.mdx b/docs/tutorials/developer-journey/level-3/3.3-certified-data.mdx index dcc5953dd5..559b10f49c 100644 --- a/docs/tutorials/developer-journey/level-3/3.3-certified-data.mdx +++ b/docs/tutorials/developer-journey/level-3/3.3-certified-data.mdx @@ -51,7 +51,7 @@ A certificate for each piece of certified data consists of: To certify data, a canister uses the following workflow: -- First, a canister must construct a hash tree that maps the paths of HTTPS resources to SHA0256 hashes. An example of this tree is: +- First, a canister must construct a hash tree that maps the paths of HTTPS resources to SHA-256 hashes. An example of this tree is: ```bash *root* From 1c1e8b78afddd2c7490d943f7761946706d95a02 Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Fri, 26 Apr 2024 13:40:28 -0500 Subject: [PATCH 4/8] Update 3.4-intro-to-agents.mdx --- .../developer-journey/level-3/3.4-intro-to-agents.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx b/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx index 503c0c254a..afc69b9cd7 100644 --- a/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx +++ b/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx @@ -98,7 +98,7 @@ npm install ### Generating Candid declarations -For this example, you'll use an example project that takes a variable size input and generates a random maze using that size. For example, if `6` is entered, a 6x6 maze will be generated. Recall that Motoko projects have the ability to autogenerate the project's Candid files. Let's start with generating those Candid files with the command: +For this example, you'll use an example project that takes a variable size input and generates a random maze using that size. For example, if `6` is entered, a 6x6 maze will be generated. Recall that Motoko projects have the ability to autogenerate the project's Candid files. Let's start with generating those Candid files with the command: ```bash dfx generate @@ -128,7 +128,7 @@ service : { } ``` -Recall that this Candid interface specification defines a service interface with a single method. The single method, `generate` accepts a single argument of type `Nat` and returns type `Text`. This is because you will enter a number (`Nat`) to generate the maze, which will then be displayed using emoji characters displayed using type `Text`. Recall that unless a call is defined as a query, all calls are treated as an update call by default. +Recall that this Candid interface specification defines a service interface with a single method. The single method, `generate` accepts a single argument of type `Nat` and returns type `Text`. This is because you will enter a number (`Nat`) to generate the maze, which will then be displayed using emoji characters of type `Text`. Recall that unless a call is defined as a query, all calls are treated as an update call by default. In JavaScript, type `Text` maps to type `String`. You can see a full mapping list of Candid types and their JavaScript equivalents in the [Candid types reference.](/docs/current/references/candid-ref). @@ -272,4 +272,4 @@ Did you get stuck somewhere in this tutorial, or feel like you need additional h Next, let's take a look at identities and authentication. -- [3.5 Identities and authentication](/docs/current/tutorials/developer-journey/level-3/3.5-identities-and-auth). \ No newline at end of file +- [3.5 Identities and authentication](/docs/current/tutorials/developer-journey/level-3/3.5-identities-and-auth). From 08411a8ba5cb436ef1320417b927145dd6c00835 Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Fri, 26 Apr 2024 13:45:58 -0500 Subject: [PATCH 5/8] Update 3.4-intro-to-agents.mdx --- .../tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx b/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx index afc69b9cd7..fdcaf3c238 100644 --- a/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx +++ b/docs/tutorials/developer-journey/level-3/3.4-intro-to-agents.mdx @@ -130,7 +130,7 @@ service : { Recall that this Candid interface specification defines a service interface with a single method. The single method, `generate` accepts a single argument of type `Nat` and returns type `Text`. This is because you will enter a number (`Nat`) to generate the maze, which will then be displayed using emoji characters of type `Text`. Recall that unless a call is defined as a query, all calls are treated as an update call by default. -In JavaScript, type `Text` maps to type `String`. You can see a full mapping list of Candid types and their JavaScript equivalents in the [Candid types reference.](/docs/current/references/candid-ref). +In JavaScript, type `Text` maps to type `String`. You can see a full mapping list of Candid types and their JavaScript equivalents in the [Candid types reference](/docs/current/references/candid-ref). Next, let's look at the `src/declarations/random_maze/random_maze.did.d.ts`: From b67a2106035f6f4c0fdb4e8c4e35535c671e0bfd Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Fri, 26 Apr 2024 15:20:40 -0500 Subject: [PATCH 6/8] Update 1.4-using-cycles.mdx --- .../developer-journey/level-1/1.4-using-cycles.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/tutorials/developer-journey/level-1/1.4-using-cycles.mdx b/docs/tutorials/developer-journey/level-1/1.4-using-cycles.mdx index 7853398519..91df7ca3fa 100644 --- a/docs/tutorials/developer-journey/level-1/1.4-using-cycles.mdx +++ b/docs/tutorials/developer-journey/level-1/1.4-using-cycles.mdx @@ -141,6 +141,14 @@ dfx start --clean --background dfx identity use DevJourney ``` +This workflow utilizes the **cycles ledger** feature. If you'd like to use the **cycles wallet** instead, [view the cycles wallet documentation](/docs/current/developer-docs/getting-started/cycles/cycles-wallet). + +To use the cycles ledger, you will need [`dfx` version 0.19.0](/docs/current/developer-docs/getting-started/install/), and you will need to set the following environmental variable: + +``` +DFX_CYCLES_LEDGER_SUPPORT_ENABLE=1 +``` + Then, redeem your coupon with the command: ```bash From d33171b151d97838ac7eccfe1de9ea039d82a855 Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Fri, 26 Apr 2024 15:33:12 -0500 Subject: [PATCH 7/8] Update cycles-faucet.mdx --- .../getting-started/cycles/cycles-faucet.mdx | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/developer-docs/getting-started/cycles/cycles-faucet.mdx b/docs/developer-docs/getting-started/cycles/cycles-faucet.mdx index d21f15cb02..ce00d8715d 100644 --- a/docs/developer-docs/getting-started/cycles/cycles-faucet.mdx +++ b/docs/developer-docs/getting-started/cycles/cycles-faucet.mdx @@ -94,17 +94,19 @@ dfx identity use MyNewIdentity ## Step 10: Now, claim your cycles. -You will need to claim your free cycles by running this command: +This workflow utilizes the **cycles ledger** feature. If you'd like to use the **cycles wallet** instead, [view the cycles wallet documentation](/docs/current/developer-docs/getting-started/cycles/cycles-wallet). + +To use the cycles ledger, you will need [`dfx` version 0.19.0](/docs/current/developer-docs/getting-started/install/), and you will need to set the following environmental variable: ``` -dfx cycles --network ic redeem-faucet-coupon +DFX_CYCLES_LEDGER_SUPPORT_ENABLE=1 ``` -:::info -This workflow utilizes the **cycles ledger** feature. If you'd like to use the **cycles wallet** instead, [view the cycles wallet documentation](/docs/current/developer-docs/getting-started/cycles/cycles-wallet). +You will need to claim your free cycles by running this command: -Please note that the cycles wallet will be removed from dfx in a future release. -::: +``` +dfx cycles --network ic redeem-faucet-coupon +``` ![Claim Cycles](_attachments/faucet_step_5.png) From a3cc71d5c0511abe59b6c97365453a282595bcb3 Mon Sep 17 00:00:00 2001 From: Jessie Mongeon <133128541+jessiemongeon1@users.noreply.github.com> Date: Mon, 29 Apr 2024 08:45:32 -0500 Subject: [PATCH 8/8] Update overview.mdx --- docs/developer-docs/smart-contracts/call/overview.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/developer-docs/smart-contracts/call/overview.mdx b/docs/developer-docs/smart-contracts/call/overview.mdx index 6c191f22b2..0f87314aea 100644 --- a/docs/developer-docs/smart-contracts/call/overview.mdx +++ b/docs/developer-docs/smart-contracts/call/overview.mdx @@ -15,7 +15,7 @@ import { GlossaryTooltip } from "/src/components/Tooltip/GlossaryTooltip"; ## Introduction -To interact with a canister's methods, there are two primary types of calls that can be used: update calls and query calls. +To interact with a canister's methods, there are two primary types of calls that can be used: update calls and query calls. Canisters implement methods that can be called via update or query calls. A query method can be called as both an update and a query, whereas update methods can be called only as an update.