Merge branch 'master' into rjb/update-decentralization-roadmap

.github/workflows/docs-check.yml

@@ -0,0 +1,25 @@
+name: Validate Docs PR comments
+on:
+  issue_comment:
+    types: [created]
+    paths:
+      - docs/developer-docs/
+
+jobs:
+  check_comment:
+    runs-on: ubuntu-latest
+    steps:
+     - uses: actions/checkout@v3
+       with:
+          fetch-depth: 0
+     - uses: actions/setup-node@v4
+       with:
+          node-version: 20
+     - uses: actions/github-script@v6
+       if: contains(github.event.comment.body, 'I agree that I have run the commands and code included in this PR and have confirmed their accuracy and functionality.')
+       with:
+          script: |
+            const comments = require('./.github/workflows/scripts/comments.js');
+            await comments.create(context, github, `PR content has been validated by a reviewer.`);
+       env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/docs-tag.yml

@@ -0,0 +1,18 @@
+name: Tag Docs PRs
+on:
+  pull_request:
+    paths:
+      - docs/developer-docs/**
+jobs:
+  docs-tag:
+    name: Tag PR with documentation
+    if: ${{ github.event_name == 'pull_request' }}
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+    - name: Tag PR with documentation
+      run: |
+        gh pr edit ${{ github.event.pull_request.number }} --add-label documentation
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/check-cddl-candid.yml → .github/workflows/interface-spec.yml

@@ -1,16 +1,21 @@
-name: "check cddl and candid files"
+name: Interface Specification
 on:
   pull_request:
     paths:
+      - .github/workflows/interface-spec.yml
+      - docs/references/http-gateway-protocol-spec.md
+      - docs/references/ic-interface-spec.md
       - docs/references/_attachments/certificates.cddl
-      - docs/references/_attachments/requests.cddl
       - docs/references/_attachments/http-gateway.did
       - docs/references/_attachments/ic.did
+      - docs/references/_attachments/interface-spec-changelog.md
+      - docs/references/_attachments/requests.cddl
   push:
     branches:
       - main
 jobs:
-  cddl-candid:
+  cddl:
+    name: Check cddl files
     runs-on: ubuntu-latest
     steps:
     - name: Checkout code
@@ -19,9 +24,27 @@ jobs:
       run: |
         docker run --rm -v $PWD/docs/references/_attachments:/workdir ghcr.io/anweiss/cddl-cli:0.9.1 compile-cddl --cddl /workdir/certificates.cddl
         docker run --rm -v $PWD/docs/references/_attachments:/workdir ghcr.io/anweiss/cddl-cli:0.9.1 compile-cddl --cddl /workdir/requests.cddl
+  candid:
+    name: Check candid files
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
     - name: Check candid files
       run: |
         curl -L https://github.com/dfinity/candid/releases/download/2023-07-25/didc-linux64 -o didc
         chmod +x didc
         ./didc check docs/references/_attachments/http-gateway.did
         ./didc check docs/references/_attachments/ic.did
+  interface-spec-tag:
+    name: Tag PR with interface-spec
+    if: ${{ github.event_name == 'pull_request' }}
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+    - name: Tag PR with interface-spec
+      run: |
+        gh pr edit ${{ github.event.pull_request.number }} --add-label interface-spec
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -29,3 +29,5 @@ stats.py
 unlighthouse.config.ts
 # Local Netlify folder
 .netlify
+roadmap.json
+roadmap.d.ts

README.md

@@ -588,25 +588,29 @@ The [Ecosystem Helper](https://mvw4g-yiaaa-aaaam-abnva-cai.icp0.io/) is an oncha
 
 ### Asset guidelines
 
-| Asset       |          | Requirements | Format       | Notes                                                                             |
-|-------------|----------|--------------|--------------|-----------------------------------------------------------------------------------|
-| logo        | required | 112x112px    | webp/svg/png | Currently displayed 56x56px                                                       |
-| screenshots | optional | 1024x576px   | webp/jpg     | The schema supports multiple files, but only the first one will be displayed      |
-| video       | optional | max 10MB     | webm/mp4     | If there is a video file specified, it will be displayed instead of a screenshot. |
+| Asset       |          | Requirements                    | Format                    | Notes                                                                                  |
+|-------------|----------|---------------------------------|---------------------------|----------------------------------------------------------------------------------------|
+| logo        | required | 112x112px (1:1 aspect ratio)    | svg(recommended)/png/webp | Optimize file size with [SVGOMG](https://svgomg.net) or [TinyPNG](https://tinypng.com) |
+| screenshots | optional | 1024x576px                      | webp/jpg                  | The schema supports multiple files, but only the first one will be displayed           |
+| video       | optional | max 10MB                        | webm/mp4                  | If there is a video file specified, it will be displayed instead of a screenshot.      |
 
 ### Tags
 
 The list of tags is not final, and will be updated as the project evolves. For now, the following tags are available:
 
-- `Wallet`
+- `AI`
+- `Chain Fusion`
 - `Bitcoin`
-- `NFT`
-- `SocialFi`
+- `Ethereum`
+- `DAO`
 - `DeFi`
+- `Enterprise`
 - `Games`
-- `DAO`
 - `Metaverse`
+- `NFT`
+- `SocialFi`
 - `Tools / Infrastructure`
+- `Wallet`
 
 ### Object schema
 
@@ -617,7 +621,7 @@ The list of tags is not final, and will be updated as the project evolves. For n
     oneLiner: string, // short description of the project
     website: string, // URL starting with `https://`
 
-    tags: ('Wallet' | 'Bitcoin' | 'NFT' | 'SocialFi' | 'DeFi' | 'Games' | 'DAO' | 'Metaverse' | 'Tools / Infrastructure')[],
+    tags: ('AI' | 'Chain Fusion' | 'Bitcoin' | 'Ethereum' | 'DAO' | 'DeFi' | 'Enterprise' | 'Games' | 'Metaverse' | 'NFT' | 'SocialFi' | 'Tools / Infrastructure' | 'Wallet')[],
     description: string, // description of the project
     stats: string, // eg. "10,000 users"
     logo: string, // url to logo file, eg. /img/showcase/awesome-icp-project_logo.webp

blog/features/async-performance-counter.md

@@ -14,7 +14,7 @@ image: /img/blog/async-performance-counter.webp
 
 ## Background
 
-The Internet Computer can host a full dapp — frontend, backend and data. Users can deploy their dapp as a canister (smart contract) on the Internet Computer. Each canister can store up to 400 GB of data and execute up to 20 Billion WebAssembly instructions per transaction.
+The Internet Computer can host a full dapp — frontend, backend and data. Users can deploy their dapp as a canister (smart contract) on the Internet Computer. Each canister can store up to 500GiB of data and execute up to 40 Billion WebAssembly instructions per transaction.
 
 Unlike other blockchains, the Internet Computer offers developers [enormous amounts of resources](/docs/current/developer-docs/smart-contracts/maintain/resource-limits). This poses a real challenge for canister developers: writing efficient canister code. The more efficient a canister is, the less cycles it pays.
 
@@ -113,7 +113,7 @@ But in this case there is no need to instrument every single await point in the
 
 ## Using performance counters
 
-To quickly run the performance counters example (assuming the Internet Computer SDK is [already installed](/docs/current/developer-docs/getting-started/install/)):
+To quickly run the performance counters example (assuming the Internet Computer SDK is [already installed](/docs/current/developer-docs/getting-started/install)):
 
 ```
 $ git clone git@github.com:dfinity/examples.git

blog/features/composite-query.md

@@ -73,7 +73,7 @@ The complete code can be found [here](https://github.com/dfinity/examples/tree/m
 An alternative implementation for Motoko can be found [here](https://github.com/dfinity/examples/tree/master/motoko/composite_query).
 
 ## Using composite queries
-To start, let's set up our development environment. Make sure you have [dfx](/docs/current/developer-docs/getting-started/install/) installed on your computer. You will need at least version 0.15.0 of dfx for composite query support. Open your terminal and follow these commands:
+To start, let's set up our development environment. Make sure you have [dfx](/docs/current/developer-docs/getting-started/install) installed on your computer. You will need at least version 0.15.0 of dfx for composite query support. Open your terminal and follow these commands:
 
 ```bash
 DFX_VERSION=0.15.0-beta.1 sh -ci "$(curl -fsSL https://internetcomputer.org/install.sh)"

blog/features/evm-rpc-canister-launch.mdx

@@ -116,7 +116,7 @@ hopefully it still shows you how easy it is to get started.
 
 <!-- prettier-ignore-start -->
 :::info
-Please ensure you [install](/docs/current/developer-docs/getting-started/install/) `dfx` before proceeding with the steps below.
+Please ensure you [install](/docs/current/developer-docs/getting-started/install) `dfx` before proceeding with the steps below.
 :::
 <!-- prettier-ignore-end -->
 

blog/news-and-updates/2023-09-27-update.mdx

@@ -104,7 +104,7 @@ The workflow for requesting a cycles coupon has been changed. Previously, when d
 
 Now, developers can use a Discord bot to request a cycles coupon. The bot will automatically send them the link to the survey, cutting out the previous delay that developers faced when awaiting a team member. Once the survey has been filled out, the DFINITY team will review it, then mark it as complete. Once marked complete, the bot will send the developer the coupon.
 
-Want to check out the updated instructions? Read the documentation [here](/docs/current/developer-docs/getting-started/cycles/cycles-faucet).
+Want to check out the updated instructions? Read the documentation [here](/docs/current/developer-docs/getting-started/tokens-and-cycles).
 
 
 ## New developer documentation

blog/news-and-updates/2023-11-01-update.mdx

@@ -119,7 +119,7 @@ This week, the developer docs saw several updates, which include:
 - The [ledger reference documentation](/docs/current/references/ledger#_accounts) has been updated to include the new `account_identifier` method.
 - A new document on the [canister history](/docs/current/developer-docs/smart-contracts/maintain/history) feature has been created.
 - A new community-contributed JavaScript signature verification library has been added to the documentation for [independently verifying signatures](/docs/current/developer-docs/web-apps/independently-verifying-ic-signatures).
-- The [playground documentation](/docs/current/developer-docs/getting-started/deploy/testnet) has been updated to include instructions for how to create a custom local playground instance.
+- The [playground documentation](/docs/current/developer-docs/getting-started/deploy-and-manage) has been updated to include instructions for how to create a custom local playground instance.
 
 That'll wrap things up for this week! See everyone in the next issue of developer weekly!
 

blog/news-and-updates/2024-01-31-update.mdx

@@ -33,9 +33,9 @@ The most notable of these updates is the newly reformatted top and side navigati
 
 UI changes aren't the only new updates, though. There are a handful of brand new documentation pages, such as:
 
-- [Hello, world! Getting started guide](/docs/current/developer-docs/getting-started/hello-world).
+- [Hello, world! Getting started guide](/docs/current/developer-docs/getting-started/write-smart-contracts).
 
-- [Creating a developer account](/docs/current/developer-docs/getting-started/accounts).
+- [Creating a developer account](/docs/current/developer-docs/getting-started/identities).
 
 - [Introduction to Solidity smart contracts](/docs/current/developer-docs/backend/solidity/).
 

blog/news-and-updates/2024-11-20-update.mdx

@@ -0,0 +1,48 @@
+---
+title: Developer weekly update November 20, 2024
+description: This week, we have tooling updates for PocketIC, dfx, and Motoko.
+tags: [Devs]
+image: /img/blog/dev-update-blog-nov-20.jpg
+---
+
+# Developer weekly update November 20, 2024
+
+![November 20 2024](../../static/img/blog/dev-update-blog-nov-20.jpg)
+
+Hello developers, and welcome to this week's developer weekly update! This week, we have tooling updates for PocketIC, dfx, and Motoko. Let's get started!
+
+## PocketIC 7.0.0
+
+A new version of PocketIC has been released! This version is packed with new features, including:
+
+- Windows support for using the Rust library natively on Windows if Windows Subsystem for Linux (WSL) is installed.
+
+- New server endpoint: `/instances/<instance_id>/_/topology`
+
+- New Rust library module for using the management canister: `pocket_ic::management_canister`.
+
+- Bitcoin integration support via the management canister.
+
+[Read more on the forum](https://forum.dfinity.org/t/pocketic-version-7-0-0-bitcoin-integration-and-windows-support/37344).
+
+## `dfx v0.24.2`
+
+The latest version of `dfx` has been released this past week. This release includes new features such as:
+
+- All commands will use the `DFX_NETWORK` environment variable by default if it is set. The `--network` flag will take precedence if provided.
+
+- `dfx generate` honors the `--network` flag.
+
+- Support for the canister log allowed viewer list.
+
+[Read the full release notes](https://github.com/dfinity/sdk/releases/tag/0.24.2).
+
+## Motoko v0.13.2
+
+The most recent version of Motoko enables an actor's self identifier to be available in the top-level block, allowing functions to refer to self from the initializer.
+
+[Read the full release notes](https://github.com/dfinity/motoko/releases/tag/0.13.2).
+
+That'll wrap up this week. Tune back in next week for more developer updates!
+
+-DFINITY

blog/news-and-updates/2024-11-27-update.mdx

@@ -0,0 +1,34 @@
+---
+title: Developer weekly update November 27, 2024
+description: This week we have two community projects to showcase, Toolkit and Linkpin, and a reminder about developer office hours in the ICP Discord.
+tags: [Devs]
+image: /img/blog/dev-update-blog-nov-27.jpg
+---
+
+# Developer weekly update November 27, 2024
+
+![November 27 2024](../../static/img/blog/dev-update-blog-nov-27.jpg)
+
+Hello developers, and welcome to this week's developer weekly update! This week we have two community projects to showcase, Toolkit and Linkpin, and a reminder about developer office hours in the ICP Discord. Let's get started!
+
+## Toolkit
+
+Toolkit is a dapp management platform with an initial focus on providing tooling for Service Nervous System (SNS) projects. It is designed to simplify dapp development, deployment, scaling, and collaboration. It provides tools to interact with SNS treasuries, mechanisms, and proposals. Developers can also use Toolkit to experiment with dapp governance and management.
+
+[Learn more about Toolkit](https://docs.ic-toolkit.app/docs/intro).
+
+## Linkpin
+
+Linkpin is an onchain bookmark manager, enabling you to login with Internet Identity, save a URL as a bookmark, and then reference that bookmark at a later time. Bookmarks can be managed by alphabetical order, number of clicks, or the last time you visited them. Linkpin utilizes ICP for all data storage and uses a backend written in Motoko.
+
+Linkpin is open source and fully customizable. Check out the code on [GitHub](https://github.com/tagoso/linkpin) for more information.
+
+## Developer office hours
+
+Every Wednesday, the ICP Discord server hosts two office hour sessions: 9 AM CET (8 AM UTC) and 10:30 AM PST (18:30 UTC). Each office hour is hosted in a drop-in style, enabling you to drop into the conversation as you please.
+
+Join the ICP Developer Discord: https://discord.internetcomputer.org/
+
+That'll wrap up this week. Tune back in next week for more developer updates!
+
+-DFINITY