Merge branch 'master' into master

dfinity · Feb 21, 2025 · 1812749 · 1812749
2 parents 7c6b1fc + ff0a111
commit 1812749
Show file tree

Hide file tree

Showing 306 changed files with 5,696 additions and 2,057 deletions.
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -13,9 +13,10 @@ docs/developer-docs/web-apps/custom-domains @dfinity/boundary-node
 docs/developer-docs/web-apps/http-compatible-canisters @dfinity/trust
 
 # Each piece of documentation must be owned by the respective teams
-docs/developer-docssmart-contracts/advanced-features/simd.mdx @dfinity/execution
-docs/developer-docssmart-contracts/advanced-features/periodic-tasks.mdx @dfinity/execution
+docs/developer-docs/smart-contracts/advanced-features/simd.mdx @dfinity/execution
+docs/developer-docs/smart-contracts/advanced-features/periodic-tasks.mdx @dfinity/execution
 docs/developer-docs/smart-contracts/best-practices/idempotency.mdx @dfinity/research @dfinity/product-security
+docs/developer-docs/smart-contracts/maintain/backtraces.mdx @dfinity/execution
 
 # The Interface Specification
 docs/references/_attachments/certificates.cddl @dfinity/canister-os

diff --git a/.github/workflows/cd.yml b/.github/workflows/cd.yml
@@ -33,8 +33,6 @@ jobs:
 
       - name: Install DFX
         uses: dfinity/setup-dfx@main
-        with:
-          dfx-version: "0.22.0"
 
       - name: Dump Identity
         run: |
@@ -69,6 +67,8 @@ jobs:
           CONTENTFUL_SPACE_ID: ${{ secrets.CONTENTFUL_SPACE_ID }}
           AIRTABLE_KEY: ${{ secrets.AIRTABLE_SA_PORTAL_SERVICE_ACCOUNT }}
           YOUTUBE_API_KEY: ${{ secrets.YOUTUBE_API_KEY }}
+          DFX_WARNING: -mainnet_plaintext_identity
+
 
       - name: Get URL
         id: get-url

diff --git a/.github/workflows/interface-spec.yml b/.github/workflows/interface-spec.yml
@@ -1,6 +1,6 @@
 name: Interface Specification
 on:
-  pull_request:
+  pull_request_target:
     paths:
       - .github/workflows/interface-spec.yml
       - docs/references/http-gateway-protocol-spec.md
@@ -38,7 +38,7 @@ jobs:
         ./didc check docs/references/_attachments/ic.did
   interface-spec-tag:
     name: Tag PR with interface-spec
-    if: ${{ github.event_name == 'pull_request' }}
+    if: ${{ github.event_name == 'pull_request_target' }}
     runs-on: ubuntu-latest
     steps:
     - name: Checkout code

diff --git a/.github/workflows/preview-deployment.yml b/.github/workflows/preview-deployment.yml
@@ -88,6 +88,7 @@ jobs:
 
         env:
           DFX_IDENTITY_PREVIEW: ${{ secrets.DFX_IDENTITY_PREVIEW }}
+          DFX_WARNING: -mainnet_plaintext_identity
           POOL_CANISTER_ID: ${{ secrets.POOL_CANISTER_ID }}
           CONTENTFUL_ACCESS_TOKEN: ${{ secrets.CONTENTFUL_ACCESS_TOKEN }}
           CONTENTFUL_HOST: ${{ secrets.CONTENTFUL_HOST }}

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -119,7 +119,7 @@ version 2.0, available at
 https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
 
 Community Impact Guidelines were inspired by [Mozilla's code of conduct
-enforcement ladder](https://github.com/mozilla/diversity).
+enforcement liftoff](https://github.com/mozilla/diversity).
 
 [homepage]: https://www.contributor-covenant.org
 

diff --git a/MAINTENANCE.md b/MAINTENANCE.md
@@ -1,19 +1,20 @@
-# Updating motoko content
+# Updating Motoko content
 
+```
 cd portal/
 git submodule update --init # if necessary
 cd submodules/motoko
-git checkout 0.7.6 #or whatever new tag you desire
+git checkout 0.14.1 #or whatever new tag you desire
 cd ../..
 git add submodules/motoko # add the change to the submodule
+```
+Replace `static/moc-interpreter-0.14.0.js` with `static/moc_interpreter-0.14.1.js` downloaded from the Motoko release page.
 
-Now replace static/moc-interpreter-0.7.3.js with static/moc_interpreter-0.7.6.js, downloaded from motoko release page. It would be better if this wasn't checked in, but, for now, it is.
-
-Edit static/load_moc.ts to use the correct version of the interpreter and base libs.
-
-Finally, edit docs/motoko/version.md to report the current version of motoko.
+Edit `static/load_moc.ts` to use the correct version of the interpreter and base libs.
 
+Finally, edit `docs/motoko/version.md` to report the current version of Motoko.
+```
 git add -u
-git commit -m "updating motoko doc"
+git commit -m "chore: updating motoko doc"
 git push
-
+```
diff --git a/README.md b/README.md
@@ -66,7 +66,7 @@ docs
 ├── motoko // Motoko documentation - submodule
 ├── references // reference documentation
 ├── samples // sample projects - submodule
-├── tutorials // tutorial series (developer ladder, hackathon prep course, etc).
+├── tutorials // tutorial series (developer liftoff, hackathon prep course, etc).
 ```
 
 # Contributing to the Dev Docs
@@ -150,7 +150,7 @@ Concept pages describe in more detail a specific concept of ICP. Concept pages s
 Concept pages should remain simple and high-level without providing unnecessary, in-depth details. Readers should be able to quickly understand the technology and its benefits, convincing them to continue learning more and begin developing using the technology.
 
 #### Tutorial
-A tutorial uses a step-by-step format to walk a user through a specific workflow. The Developer Ladder is an example of a tutorial series.
+A tutorial uses a step-by-step format to walk a user through a specific workflow. The Developer Liftoff is an example of a tutorial series.
 
 #### Reference
 A reference page provides low level detail into a feature or technology. API reference pages are an example that provide in-depth detail about different endpoints and methods. Some examples include:
@@ -593,33 +593,27 @@ The [Ecosystem Helper](https://mvw4g-yiaaa-aaaam-abnva-cai.icp0.io/) is an oncha
 
 The list of tags is not final, and will be updated as the project evolves. For now, the following tags are available:
 
-- `AI`
 - `Chain Fusion`
 - `Bitcoin`
-- `Ethereum`
-- `DAO`
 - `DeFi`
-- `Enterprise`
-- `Gaming`
-- `Metaverse`
-- `NFT`
-- `SocialFi`
-- `Tools / Infrastructure`
 - `Wallet`
-- `Analytics`
+- `AI`
+- `Gaming`
 - `Creator Economy`
+- `Enterprise`
+- `Analytics`
+- `Tools / Infrastructure`
 
 ### Object schema
 
 ```json
   {
     id: string,
     name: string,
-    oneLiner: string, // short description of the project
     website: string, // URL starting with `https://`
 
-    tags: ('AI' | 'Chain Fusion' | 'Bitcoin' | 'Ethereum' | 'DAO' | 'DeFi' | 'Enterprise' | 'Gaming' | 'Metaverse' | 'NFT' | 'SocialFi' | 'Tools / Infrastructure' | 'Wallet' | 'Analytics' | 'Creator Economy')[],
-    description: string, // description of the project
+    tags: ( `Chain Fusion` | `Bitcoin` | `DeFi` | `Wallet` | `AI` | `Gaming` | `Creator Economy` | `Enterprise` |`Analytics` | `Tools / Infrastructure`)[],
+    description: string, // description of the project - up to 150 characters
     stats: string, // eg. "10,000 users"
     logo: string, // url to logo file, eg. /img/showcase/awesome-icp-project_logo.webp
 

diff --git a/blog/news-and-updates/2023-08-16-update.mdx b/blog/news-and-updates/2023-08-16-update.mdx
@@ -1,6 +1,6 @@
 ---
 title: Developer weekly update August 16, 2023
-description: In this issue, we're excited to introduce the first portion of a new documentation series, Developer Ladder, plus talk about the upcoming `dfx` release and new documentation on the Motoko feature `mo-doc`.
+description: In this issue, we're excited to introduce the first portion of a new documentation series, Developer Liftoff, plus talk about the upcoming `dfx` release and new documentation on the Motoko feature `mo-doc`.
 tags: [Devs]
 image: /img/blog/dev-update-blog-aug-16.jpg
 ---
@@ -9,11 +9,11 @@ image: /img/blog/dev-update-blog-aug-16.jpg
 
 ![August 16 2023](../../static/img/blog/dev-update-blog-aug-16.jpg)
 
-Hey developers! Welcome to this week's developer weekly update. In this issue, we're excited to introduce the first portion of a new documentation series: Developer Ladder, plus talk about the upcoming `dfx` release and new documentation on the Motoko feature `mo-doc`.
+Hey developers! Welcome to this week's developer weekly update. In this issue, we're excited to introduce the first portion of a new documentation series: Developer Liftoff, plus talk about the upcoming `dfx` release and new documentation on the Motoko feature `mo-doc`.
 
-## Introducing the Developer Ladder
+## Introducing the Developer Liftoff
 
-Today we're excited to introduce the new Developer Ladder tutorial series! This series is designed to bring new developers on a detailed, diverse journey through development on the Internet Computer. The journey starts with 'pre-flight operations', which is an introductory level that provides context for the remainder of the journey, such as an overview of what ICP is, how it works, and how to set up your developer environment. Then, the journey will bring you through a series of modules to develop your skills and learn about additional ICP components in order to become an ICP astronaut!
+Today we're excited to introduce the new Developer Liftoff tutorial series! This series is designed to bring new developers on a detailed, diverse journey through development on the Internet Computer. The journey starts with 'pre-flight operations', which is an introductory level that provides context for the remainder of the journey, such as an overview of what ICP is, how it works, and how to set up your developer environment. Then, the journey will bring you through a series of modules to develop your skills and learn about additional ICP components in order to become an ICP astronaut!
 
 Overall, the journey will contain the following modules and components:
 
@@ -101,7 +101,7 @@ Overall, the journey will contain the following modules and components:
 
 - 5.6: Next steps.
 
-The first portion of this series, Level 0: Pre-flight operations, is out now and ready for you to follow along with! You can get started with the Developer Ladder [here](https://internetcomputer.org/docs/current/tutorials/developer-journey/level-0/).
+The first portion of this series, Level 0: Pre-flight operations, is out now and ready for you to follow along with! You can get started with the Developer Liftoff [here](https://internetcomputer.org/docs/current/tutorials/developer-liftoff/level-0/).
 
 ## Upcoming `dfx 0.15` release
 
@@ -111,13 +111,13 @@ The first portion of this series, Level 0: Pre-flight operations, is out now and
 
 - Fixes for the asset canister's response verification v2. We dove into this fix a bit further in last week's developer weekly update [here](2023-08-09-update.mdx).
 
-- Removal of the `dfx nns` and `dfx sns` commands, which will be part of the new upcoming subcommand, `dfx extensions`. 
+- Removal of the `dfx nns` and `dfx sns` commands, which will be part of the new upcoming subcommand, `dfx extensions`.
 
-A detailed breakdown of the full release notes will be available in an upcoming blog post. Stay tuned! 
+A detailed breakdown of the full release notes will be available in an upcoming blog post. Stay tuned!
 
 ## `mo-doc`
 
-`mo-doc` is a command-line tool that can be used to generate documentation for Motoko code. It can generate various formats of documentation based on Motoko source code. 
+`mo-doc` is a command-line tool that can be used to generate documentation for Motoko code. It can generate various formats of documentation based on Motoko source code.
 
 To use `mo-doc`, you can download it directly from the Motoko Github releases page, or use the binary that is included in `dfx`.
 
@@ -133,7 +133,7 @@ The options for the tool are:
 
 - `--output <path>`: This option specifies the directory where the documentation will be generated; the default is `docs`.
 
-- `--format <format>`: This option specifies the generated format, which can be HTML, ADOC, or Markdown; the default is HTML. 
+- `--format <format>`: This option specifies the generated format, which can be HTML, ADOC, or Markdown; the default is HTML.
 
 - `--help`: This option shows usage information.
 

diff --git a/blog/news-and-updates/2023-09-06-update.mdx b/blog/news-and-updates/2023-09-06-update.mdx
@@ -1,6 +1,6 @@
 ---
 title: Developer weekly update September 6, 2023
-description: This week, we're excited to talk about the next installment of the new documentation series Developer ladder, plus talk about upcoming features and integrations such as the Ethereum integration and the cycles ledger.
+description: This week, we're excited to talk about the next installment of the new documentation series Developer liftoff, plus talk about upcoming features and integrations such as the Ethereum integration and the cycles ledger.
 tags: [Devs]
 image: /img/blog/dev-update-blog-sept-6.jpg
 ---
@@ -9,15 +9,15 @@ image: /img/blog/dev-update-blog-sept-6.jpg
 
 ![September 6 2023](../../static/img/blog/dev-update-blog-sept-6.jpg)
 
-Hello devs and welcome to this week's issue of developer weekly! This week, we're excited to talk about the next installment of the new documentation series developer ladder, plus talk about upcoming features and integrations such as the Ethereum integration and the cycles ledger.
+Hello devs and welcome to this week's issue of developer weekly! This week, we're excited to talk about the next installment of the new documentation series developer liftoff, plus talk about upcoming features and integrations such as the Ethereum integration and the cycles ledger.
 
-Let's get into it! 
+Let's get into it!
 
-## Developer ladder level 1
+## Developer liftoff level 1
 
-The second level of the developer ladder tutorial series is now live on the developer docs! In this level, level 1, we begin to dive into the building blocks of developing on ICP, such as learning about Motoko fundamentals, developing a simple poll dapp, and learning about canister deployment and management. Modules in this level include:
+The second level of the developer liftoff tutorial series is now live on the developer docs! In this level, level 1, we begin to dive into the building blocks of developing on ICP, such as learning about Motoko fundamentals, developing a simple poll dapp, and learning about canister deployment and management. Modules in this level include:
 
-- [1.1: Exploring a live demo](/docs/current/tutorials/developer-journey/level-1/1.1-live-demo):
+- [1.1: Exploring a live demo](/docs/current/tutorials/developer-liftoff/level-1/1.1-live-demo):
 
 In this module, you can learn about:
 
@@ -27,7 +27,7 @@ In this module, you can learn about:
     - Interacting with the canister via the CLI.
     - Interacting with the canister via the Candid interface.
 
-- [1.2: Motoko level 1](/docs/current/tutorials/developer-journey/level-1/1.2-motoko-lvl1):
+- [1.2: Motoko level 1](/docs/current/tutorials/developer-liftoff/level-1/1.2-motoko-lvl1):
 
 In this module, you can learn about:
 
@@ -42,7 +42,7 @@ In this module, you can learn about:
     - Printing values.
     - Passing text arguments.
 
-- [1.3: Developing your first dapp](/docs/current/tutorials/developer-journey/level-1/1.3-first-dapp): 
+- [1.3: Developing your first dapp](/docs/current/tutorials/developer-liftoff/level-1/1.3-first-dapp):
 
 In this module, you can learn about:
 
@@ -63,7 +63,7 @@ In this module, you can learn about:
     - Adding pre-developed frontend code.
     - Re-deploying the dapp.
 
-- [1.4: Acquiring and using cycles](/docs/current/tutorials/developer-journey/level-1/1.4-using-cycles):
+- [1.4: Acquiring and using cycles](/docs/current/tutorials/developer-liftoff/level-1/1.4-using-cycles):
 
 In this module, you can learn about:
 
@@ -72,11 +72,11 @@ In this module, you can learn about:
     - Acquiring cycles using a cycles coupon.
     - Converting ICP tokens to cycles.
 
-- [1.5: Deploying canisters](/docs/current/tutorials/developer-journey/level-1/1.5-deploying-canisters): 
+- [1.5: Deploying canisters](/docs/current/tutorials/developer-liftoff/level-1/1.5-deploying-canisters):
 
 In this module, you can learn about deploying to the mainnet.
 
-- [1.6: Managing canisters](/docs/current/tutorials/developer-journey/level-1/1.6-managing-canisters): 
+- [1.6: Managing canisters](/docs/current/tutorials/developer-liftoff/level-1/1.6-managing-canisters):
 
 In this module, you can learn about:
 
@@ -90,7 +90,7 @@ In this module, you can learn about:
     - Setting the canister's freezing threshold.
     - Deleting a canister.
 
-You can learn more about the developer ladder and get started with level 0 in the [tutorials section of our developer documentation](/docs/current/tutorials/developer-journey/).
+You can learn more about the developer liftoff and get started with level 0 in the [tutorials section of our developer documentation](/docs/current/tutorials/developer-liftoff/).
 
 ## Ethereum starter project
 
@@ -103,13 +103,13 @@ If you want to use this sample project as a boilerplate to build your own, or le
 
 ## Upcoming feature: cycles ledger
 
-Another exciting upcoming feature is the new cycles ledger feature. The cycles ledger, which is expected to launch in October 2023, will simplify cycle management by providing the ability for principal IDs to hold cycles. 
+Another exciting upcoming feature is the new cycles ledger feature. The cycles ledger, which is expected to launch in October 2023, will simplify cycle management by providing the ability for principal IDs to hold cycles.
 
-Currently, cycles wallets are a complex solution that is used to associate cycles with principals, since cycles wallets must be deployed locally, consume cycles themselves, and are easily lost if the cycles wallet canister ID is lost. 
+Currently, cycles wallets are a complex solution that is used to associate cycles with principals, since cycles wallets must be deployed locally, consume cycles themselves, and are easily lost if the cycles wallet canister ID is lost.
 
-The cycles ledger is an alternative to the cycles wallet, and will be deployed as a single global ledger canister, rather than a local deployment. The cycles ledger will comply with the ICRC-2 standard and will also interact with the NNS canisters and user canisters to provide ledger-specific functions, such as creating new canisters using cycles, sending cycles to canisters, and accepting incoming cycles. 
+The cycles ledger is an alternative to the cycles wallet, and will be deployed as a single global ledger canister, rather than a local deployment. The cycles ledger will comply with the ICRC-2 standard and will also interact with the NNS canisters and user canisters to provide ledger-specific functions, such as creating new canisters using cycles, sending cycles to canisters, and accepting incoming cycles.
 
-Be sure to check back in October for a more detailed blog post when the feature is live! 
+Be sure to check back in October for a more detailed blog post when the feature is live!
 
 That'll wrap things up for now, see you next time!
 

diff --git a/blog/news-and-updates/2023-09-13-update.mdx b/blog/news-and-updates/2023-09-13-update.mdx
@@ -41,9 +41,9 @@ Want to get started? The interactive tutorial can be found in our Motoko documen
 
 Over the past few weeks, we've had some great new pages added to our developer documentation. Let's take a look at some of the new additions!
 
-- [Developer ladder level 0](/docs/current/tutorials/developer-journey/level-0/): Start the developer ladder at the very beginning by following the level 0 module. In level 0, we cover the fundamentals of what the Internet Computer is, what terms you should be familiar with, and what tools we'll be using throughout our journey.
+- [Developer liftoff level 0](/docs/current/tutorials/developer-liftoff/level-0/): Start the developer liftoff at the very beginning by following the level 0 module. In level 0, we cover the fundamentals of what the Internet Computer is, what terms you should be familiar with, and what tools we'll be using throughout our journey.
 
-- [Developer ladder level 1](/docs/current/tutorials/developer-journey/level-1/): In the next stage of the developer ladder, become a space cadet by getting comfortable creating your first dapp, managing your canisters, and acquiring and using cycles.
+- [Developer liftoff level 1](/docs/current/tutorials/developer-liftoff/level-1/): In the next stage of the developer liftoff, become a space cadet by getting comfortable creating your first dapp, managing your canisters, and acquiring and using cycles.
 
 - [Pulling canister dependencies](/docs/current/developer-docs/smart-contracts/maintain/import): Learn how to use the new `dfx deps` feature to pull third-party canister dependencies.