From 73bf472c285c4ab23869a2df66681dc48b0676f6 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy Date: Mon, 6 Nov 2023 17:24:00 +0100 Subject: [PATCH 01/24] add api boundary nodes --- spec/index.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 6c99e0207..3fb01da8d 100644 --- a/spec/index.md +++ b/spec/index.md @@ -431,6 +431,11 @@ This section specifies the publicly relevant paths in the tree. All partial state trees include a timestamp, indicating the time at which the state is current. +### Api boundary bodes information {#state-tree-subnet} +The state tree contains information about all API Boundary Nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these Api boundary node records is stored in the registry canister and can be added/modified/removed via proposals. +- `api_boundary_nodes//domain` (text) + + The domain name associated with a node, e.g., `api-bn1.dfinity.org`. ### Subnet information {#state-tree-subnet} The state tree contains information about the topology of the Internet Computer. @@ -697,7 +702,7 @@ canister developers that aim at keeping data confidential are advised to add a s All requested paths must have the following form: - `/time`. Can always be requested. - +- `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`. Can always be requested. - `/subnet`, `/subnet/`, `/subnet//public_key`, `/subnet//canister_ranges`, `/subnet//metrics`, `/subnet//node`, `/subnet//node/`, `/subnet//node//public_key`. Can always be requested. - `/request_status/`, `/request_status//status`, `/request_status//reply`, `/request_status//reject_code`, `/request_status//reject_message`, `/request_status//error_code`. Can be requested if no path with such a prefix exists in the state tree or From 53169bf09e01d5f9c18416ad0111f7e4ab26be8b Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Mon, 6 Nov 2023 20:43:20 +0100 Subject: [PATCH 02/24] Update spec/index.md Co-authored-by: r-birkner <103420898+r-birkner@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 3fb01da8d..8fc8102e6 100644 --- a/spec/index.md +++ b/spec/index.md @@ -435,7 +435,7 @@ This section specifies the publicly relevant paths in the tree. The state tree contains information about all API Boundary Nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these Api boundary node records is stored in the registry canister and can be added/modified/removed via proposals. - `api_boundary_nodes//domain` (text) - The domain name associated with a node, e.g., `api-bn1.dfinity.org`. + The domain name associated with a node, e.g., `api-bn1.example.com`. ### Subnet information {#state-tree-subnet} The state tree contains information about the topology of the Internet Computer. From af82f21ca3b9f682ce527198fff3245ac00352ec Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Mon, 6 Nov 2023 20:43:39 +0100 Subject: [PATCH 03/24] Update spec/index.md Co-authored-by: r-birkner <103420898+r-birkner@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 8fc8102e6..66b11df4c 100644 --- a/spec/index.md +++ b/spec/index.md @@ -432,7 +432,7 @@ This section specifies the publicly relevant paths in the tree. All partial state trees include a timestamp, indicating the time at which the state is current. ### Api boundary bodes information {#state-tree-subnet} -The state tree contains information about all API Boundary Nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these Api boundary node records is stored in the registry canister and can be added/modified/removed via proposals. +The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister and can be added/modified/removed via proposals. - `api_boundary_nodes//domain` (text) The domain name associated with a node, e.g., `api-bn1.example.com`. From 2e9413e32c245aca4cb11d51fe92e5a82820999b Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Mon, 6 Nov 2023 20:43:51 +0100 Subject: [PATCH 04/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/spec/index.md b/spec/index.md index 66b11df4c..b863a481b 100644 --- a/spec/index.md +++ b/spec/index.md @@ -703,6 +703,7 @@ All requested paths must have the following form: - `/time`. Can always be requested. - `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`. Can always be requested. + - `/subnet`, `/subnet/`, `/subnet//public_key`, `/subnet//canister_ranges`, `/subnet//metrics`, `/subnet//node`, `/subnet//node/`, `/subnet//node//public_key`. Can always be requested. - `/request_status/`, `/request_status//status`, `/request_status//reply`, `/request_status//reject_code`, `/request_status//reject_message`, `/request_status//error_code`. Can be requested if no path with such a prefix exists in the state tree or From 338455c3a34b66aced3437e588b8cf7180de5b0f Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Mon, 6 Nov 2023 20:43:57 +0100 Subject: [PATCH 05/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index b863a481b..447e11c6d 100644 --- a/spec/index.md +++ b/spec/index.md @@ -433,7 +433,7 @@ This section specifies the publicly relevant paths in the tree. ### Api boundary bodes information {#state-tree-subnet} The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister and can be added/modified/removed via proposals. -- `api_boundary_nodes//domain` (text) +- `/api_boundary_nodes//domain` (text) The domain name associated with a node, e.g., `api-bn1.example.com`. ### Subnet information {#state-tree-subnet} From a143cafd36d0f7577634055087b373744ae12da3 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy Date: Mon, 13 Nov 2023 11:10:28 +0100 Subject: [PATCH 06/24] extend with pub_key and ip addresses --- spec/index.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 447e11c6d..4ce55c47d 100644 --- a/spec/index.md +++ b/spec/index.md @@ -434,6 +434,9 @@ This section specifies the publicly relevant paths in the tree. ### Api boundary bodes information {#state-tree-subnet} The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister and can be added/modified/removed via proposals. - `/api_boundary_nodes//domain` (text) +- `/api_boundary_nodes//public_key` (text) +- `/api_boundary_nodes//ipv4_address` (text) +- `/api_boundary_nodes//ipv6_address` (text) The domain name associated with a node, e.g., `api-bn1.example.com`. ### Subnet information {#state-tree-subnet} @@ -702,7 +705,7 @@ canister developers that aim at keeping data confidential are advised to add a s All requested paths must have the following form: - `/time`. Can always be requested. -- `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`. Can always be requested. +- `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`, `/api_boundary_nodes//pub_key`, `/api_boundary_nodes//ip4_address`, `/api_boundary_nodes//ipv6_address`. Can always be requested. - `/subnet`, `/subnet/`, `/subnet//public_key`, `/subnet//canister_ranges`, `/subnet//metrics`, `/subnet//node`, `/subnet//node/`, `/subnet//node//public_key`. Can always be requested. From 6519cb5db3817081b2e5237c0f3044a55eedd84e Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Mon, 20 Nov 2023 13:31:24 +0100 Subject: [PATCH 07/24] Update spec/index.md Co-authored-by: r-birkner <103420898+r-birkner@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 4ce55c47d..57a374e48 100644 --- a/spec/index.md +++ b/spec/index.md @@ -705,7 +705,7 @@ canister developers that aim at keeping data confidential are advised to add a s All requested paths must have the following form: - `/time`. Can always be requested. -- `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`, `/api_boundary_nodes//pub_key`, `/api_boundary_nodes//ip4_address`, `/api_boundary_nodes//ipv6_address`. Can always be requested. +- `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`, `/api_boundary_nodes//pub_key`, `/api_boundary_nodes//ipv4_address`, `/api_boundary_nodes//ipv6_address`. Can always be requested. - `/subnet`, `/subnet/`, `/subnet//public_key`, `/subnet//canister_ranges`, `/subnet//metrics`, `/subnet//node`, `/subnet//node/`, `/subnet//node//public_key`. Can always be requested. From f6272777d4164ca8d23c65a6ed604ec8fa72c545 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Fri, 15 Dec 2023 07:38:52 -0300 Subject: [PATCH 08/24] Update spec/index.md Co-authored-by: r-birkner <103420898+r-birkner@users.noreply.github.com> --- spec/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 57a374e48..98fd1c0ec 100644 --- a/spec/index.md +++ b/spec/index.md @@ -434,7 +434,6 @@ This section specifies the publicly relevant paths in the tree. ### Api boundary bodes information {#state-tree-subnet} The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister and can be added/modified/removed via proposals. - `/api_boundary_nodes//domain` (text) -- `/api_boundary_nodes//public_key` (text) - `/api_boundary_nodes//ipv4_address` (text) - `/api_boundary_nodes//ipv6_address` (text) From e724cbeab28f11c2971e1cdfa1d42ac4aa29c304 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Fri, 15 Dec 2023 07:39:01 -0300 Subject: [PATCH 09/24] Update spec/index.md Co-authored-by: r-birkner <103420898+r-birkner@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 98fd1c0ec..4b5a51b67 100644 --- a/spec/index.md +++ b/spec/index.md @@ -704,7 +704,7 @@ canister developers that aim at keeping data confidential are advised to add a s All requested paths must have the following form: - `/time`. Can always be requested. -- `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`, `/api_boundary_nodes//pub_key`, `/api_boundary_nodes//ipv4_address`, `/api_boundary_nodes//ipv6_address`. Can always be requested. +- `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`, `/api_boundary_nodes//ipv4_address`, `/api_boundary_nodes//ipv6_address`. Can always be requested. - `/subnet`, `/subnet/`, `/subnet//public_key`, `/subnet//canister_ranges`, `/subnet//metrics`, `/subnet//node`, `/subnet//node/`, `/subnet//node//public_key`. Can always be requested. From 84bb693b8e4105259dd4eb6c2ec1dfa1783140e5 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy Date: Thu, 1 Feb 2024 11:27:00 -0500 Subject: [PATCH 10/24] docs: add comment about empty ipv4_address --- spec/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/spec/index.md b/spec/index.md index 4b5a51b67..edddb0317 100644 --- a/spec/index.md +++ b/spec/index.md @@ -435,6 +435,8 @@ This section specifies the publicly relevant paths in the tree. The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister and can be added/modified/removed via proposals. - `/api_boundary_nodes//domain` (text) - `/api_boundary_nodes//ipv4_address` (text) + + If the `ipv4_address` is empty, this path does not exist. - `/api_boundary_nodes//ipv6_address` (text) The domain name associated with a node, e.g., `api-bn1.example.com`. From 6c16a135b23c28ab231548dce9b8ae4d72aca982 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy Date: Thu, 1 Feb 2024 12:06:48 -0500 Subject: [PATCH 11/24] docs: correct comment --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index edddb0317..15a7281eb 100644 --- a/spec/index.md +++ b/spec/index.md @@ -432,7 +432,7 @@ This section specifies the publicly relevant paths in the tree. All partial state trees include a timestamp, indicating the time at which the state is current. ### Api boundary bodes information {#state-tree-subnet} -The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister and can be added/modified/removed via proposals. +The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister. - `/api_boundary_nodes//domain` (text) - `/api_boundary_nodes//ipv4_address` (text) From bcc241d3c41fb70eaf3bb56768cb522a4a037c7e Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Thu, 1 Feb 2024 14:00:13 -0500 Subject: [PATCH 12/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 15a7281eb..9231731b4 100644 --- a/spec/index.md +++ b/spec/index.md @@ -432,7 +432,9 @@ This section specifies the publicly relevant paths in the tree. All partial state trees include a timestamp, indicating the time at which the state is current. ### Api boundary bodes information {#state-tree-subnet} -The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (replica nodes). The source of truth for these API boundary node records is stored in the registry canister. + +The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (its replica nodes). The source of truth for these API boundary node records is stored in the NNS registry canister. + - `/api_boundary_nodes//domain` (text) - `/api_boundary_nodes//ipv4_address` (text) From 03064ea59340cac607c6322b862819ecb3f7f582 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy Date: Thu, 1 Feb 2024 17:20:05 -0500 Subject: [PATCH 13/24] doc: add missing descriptions --- spec/index.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/spec/index.md b/spec/index.md index 9231731b4..00278cfa9 100644 --- a/spec/index.md +++ b/spec/index.md @@ -431,17 +431,23 @@ This section specifies the publicly relevant paths in the tree. All partial state trees include a timestamp, indicating the time at which the state is current. -### Api boundary bodes information {#state-tree-subnet} +### Api boundary nodes information {#state-tree-subnet} The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (its replica nodes). The source of truth for these API boundary node records is stored in the NNS registry canister. - `/api_boundary_nodes//domain` (text) + + Domain name associated with a node. All domains are unique across nodes. + Example: `api-bn1.example.com`. - `/api_boundary_nodes//ipv4_address` (text) - If the `ipv4_address` is empty, this path does not exist. + Public IPv4 address of a node in the dotted-decimal notation. + If the `ipv4_address` is empty, this path does not exist. + Example: `192.168.10.150`. - `/api_boundary_nodes//ipv6_address` (text) - The domain name associated with a node, e.g., `api-bn1.example.com`. + Public IPv6 address of a node in the hexadecimal notation with colons. + Example: `3002:0bd6:0000:0000:0000:ee00:0033:6778`. ### Subnet information {#state-tree-subnet} The state tree contains information about the topology of the Internet Computer. From c727babd2c8b98dac9db57b83321a67cb9ae67ed Mon Sep 17 00:00:00 2001 From: mraszyk <31483726+mraszyk@users.noreply.github.com> Date: Fri, 2 Feb 2024 11:36:17 +0100 Subject: [PATCH 14/24] Update spec/index.md --- spec/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/spec/index.md b/spec/index.md index 00278cfa9..fc96ead59 100644 --- a/spec/index.md +++ b/spec/index.md @@ -714,6 +714,7 @@ canister developers that aim at keeping data confidential are advised to add a s All requested paths must have the following form: - `/time`. Can always be requested. + - `/api_boundary_nodes`, `/api_boundary_nodes/`, `/api_boundary_nodes//domain`, `/api_boundary_nodes//ipv4_address`, `/api_boundary_nodes//ipv6_address`. Can always be requested. - `/subnet`, `/subnet/`, `/subnet//public_key`, `/subnet//canister_ranges`, `/subnet//metrics`, `/subnet//node`, `/subnet//node/`, `/subnet//node//public_key`. Can always be requested. From 2904bac21e9a60dc9dea45d24df03dbd46597280 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Fri, 2 Feb 2024 09:09:17 -0500 Subject: [PATCH 15/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index fc96ead59..706c2c809 100644 --- a/spec/index.md +++ b/spec/index.md @@ -431,7 +431,7 @@ This section specifies the publicly relevant paths in the tree. All partial state trees include a timestamp, indicating the time at which the state is current. -### Api boundary nodes information {#state-tree-subnet} +### Api boundary nodes information {#state-tree-api-bn} The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (its replica nodes). The source of truth for these API boundary node records is stored in the NNS registry canister. From 52b9337a365854aa455bf84075d0985fd3e16a17 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Fri, 2 Feb 2024 09:09:30 -0500 Subject: [PATCH 16/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/spec/index.md b/spec/index.md index 706c2c809..78a2a9994 100644 --- a/spec/index.md +++ b/spec/index.md @@ -439,6 +439,7 @@ The state tree contains information about all API boundary nodes, which can comm Domain name associated with a node. All domains are unique across nodes. Example: `api-bn1.example.com`. + - `/api_boundary_nodes//ipv4_address` (text) Public IPv4 address of a node in the dotted-decimal notation. From 20f64760f6d9892d7cce8595dd3c44b210f5cc81 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Fri, 2 Feb 2024 09:09:38 -0500 Subject: [PATCH 17/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/spec/index.md b/spec/index.md index 78a2a9994..bdadac5a1 100644 --- a/spec/index.md +++ b/spec/index.md @@ -445,6 +445,7 @@ The state tree contains information about all API boundary nodes, which can comm Public IPv4 address of a node in the dotted-decimal notation. If the `ipv4_address` is empty, this path does not exist. Example: `192.168.10.150`. + - `/api_boundary_nodes//ipv6_address` (text) Public IPv6 address of a node in the hexadecimal notation with colons. From 4131295c2b7ea841dac16c626a30e8e21f1783c1 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Fri, 2 Feb 2024 09:09:51 -0500 Subject: [PATCH 18/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/spec/index.md b/spec/index.md index bdadac5a1..05e870cdf 100644 --- a/spec/index.md +++ b/spec/index.md @@ -450,6 +450,7 @@ The state tree contains information about all API boundary nodes, which can comm Public IPv6 address of a node in the hexadecimal notation with colons. Example: `3002:0bd6:0000:0000:0000:ee00:0033:6778`. + ### Subnet information {#state-tree-subnet} The state tree contains information about the topology of the Internet Computer. From 939a70eddc48ecbf2e6fc4f23cba057ae8dd750e Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Fri, 2 Feb 2024 09:10:04 -0500 Subject: [PATCH 19/24] Update spec/index.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 05e870cdf..4dec9ec46 100644 --- a/spec/index.md +++ b/spec/index.md @@ -443,7 +443,7 @@ The state tree contains information about all API boundary nodes, which can comm - `/api_boundary_nodes//ipv4_address` (text) Public IPv4 address of a node in the dotted-decimal notation. - If the `ipv4_address` is empty, this path does not exist. + If no `ipv4_address` is available for the corresponding node, then this path does not exist. Example: `192.168.10.150`. - `/api_boundary_nodes//ipv6_address` (text) From f85f54f1eefb6670d28cc8970f57e997fb8d77f2 Mon Sep 17 00:00:00 2001 From: mraszyk <31483726+mraszyk@users.noreply.github.com> Date: Thu, 8 Feb 2024 11:11:57 +0100 Subject: [PATCH 20/24] Update spec/index.md --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 4dec9ec46..01b1c5b70 100644 --- a/spec/index.md +++ b/spec/index.md @@ -433,7 +433,7 @@ This section specifies the publicly relevant paths in the tree. ### Api boundary nodes information {#state-tree-api-bn} -The state tree contains information about all API boundary nodes, which can communicate with the Internet Computer (its replica nodes). The source of truth for these API boundary node records is stored in the NNS registry canister. +The state tree contains information about all API boundary nodes. The source of truth for these API boundary node records is stored in the NNS registry canister. - `/api_boundary_nodes//domain` (text) From 2c978cdaee1a00d2cf0b30cdc2fb70dad2db51f9 Mon Sep 17 00:00:00 2001 From: mraszyk <31483726+mraszyk@users.noreply.github.com> Date: Thu, 8 Feb 2024 11:48:38 +0100 Subject: [PATCH 21/24] Update spec/index.md Co-authored-by: bogwar <51327868+bogwar@users.noreply.github.com> --- spec/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/index.md b/spec/index.md index 01b1c5b70..e654e21f1 100644 --- a/spec/index.md +++ b/spec/index.md @@ -433,7 +433,7 @@ This section specifies the publicly relevant paths in the tree. ### Api boundary nodes information {#state-tree-api-bn} -The state tree contains information about all API boundary nodes. The source of truth for these API boundary node records is stored in the NNS registry canister. +The state tree contains information about all API boundary nodes (the source of truth for these API boundary node records is stored in the NNS registry canister). - `/api_boundary_nodes//domain` (text) From c90bc27e0756af7ddd8e9f9506f1f57a974346a7 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy Date: Wed, 6 Mar 2024 08:55:49 +0100 Subject: [PATCH 22/24] docs: update changelog --- spec/_attachments/interface-spec-changelog.md | 1 + 1 file changed, 1 insertion(+) diff --git a/spec/_attachments/interface-spec-changelog.md b/spec/_attachments/interface-spec-changelog.md index 7950ef214..f552d32af 100644 --- a/spec/_attachments/interface-spec-changelog.md +++ b/spec/_attachments/interface-spec-changelog.md @@ -1,6 +1,7 @@ ## Changelog {#changelog} ### ∞ (unreleased) +* Add API boundary nodes into the certified state tree and new HTTP endpoints for retrieving them. * The maximum length of a nonce in an ingress message is 32 bytes. * Update specification of responses from the endpoint `/api/v2/status`. * Stop canister calls might be rejected upon timeout. From a8ffd867ebed22ff717b568e26f739b3b046e4b0 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy Date: Wed, 6 Mar 2024 10:10:40 +0100 Subject: [PATCH 23/24] docs: update changelog --- spec/_attachments/interface-spec-changelog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/_attachments/interface-spec-changelog.md b/spec/_attachments/interface-spec-changelog.md index f552d32af..afefd8fad 100644 --- a/spec/_attachments/interface-spec-changelog.md +++ b/spec/_attachments/interface-spec-changelog.md @@ -1,7 +1,6 @@ ## Changelog {#changelog} ### ∞ (unreleased) -* Add API boundary nodes into the certified state tree and new HTTP endpoints for retrieving them. * The maximum length of a nonce in an ingress message is 32 bytes. * Update specification of responses from the endpoint `/api/v2/status`. * Stop canister calls might be rejected upon timeout. @@ -12,6 +11,7 @@ * Set the maximum depth of a delegation in a read_state response/certified variable certificate to 1. * Canister version is guaranteed to increase if the canister's running status changes. * Calls to frozen canisters are rejected with `SYS_TRANSIENT` instead of `CANISTER_ERROR`. +* Add API boundary nodes into the certified state tree and new HTTP endpoints for retrieving them. ### 0.22.0 (2023-11-15) {#0_22_0} * Add metrics on subnet usage into the certified state tree and a new HTTP endpoint `/api/v2/subnet//read_state` for retrieving them. From 8a76e487fb8a5e2a142fbf73fbb9ca41db942b17 Mon Sep 17 00:00:00 2001 From: Nikolay Komarevskiy <90605504+nikolay-komarevskiy@users.noreply.github.com> Date: Wed, 6 Mar 2024 10:12:49 +0100 Subject: [PATCH 24/24] Update spec/_attachments/interface-spec-changelog.md Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> --- spec/_attachments/interface-spec-changelog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/_attachments/interface-spec-changelog.md b/spec/_attachments/interface-spec-changelog.md index afefd8fad..8e3aa926a 100644 --- a/spec/_attachments/interface-spec-changelog.md +++ b/spec/_attachments/interface-spec-changelog.md @@ -11,7 +11,7 @@ * Set the maximum depth of a delegation in a read_state response/certified variable certificate to 1. * Canister version is guaranteed to increase if the canister's running status changes. * Calls to frozen canisters are rejected with `SYS_TRANSIENT` instead of `CANISTER_ERROR`. -* Add API boundary nodes into the certified state tree and new HTTP endpoints for retrieving them. +* Add API boundary nodes information into the certified state tree. ### 0.22.0 (2023-11-15) {#0_22_0} * Add metrics on subnet usage into the certified state tree and a new HTTP endpoint `/api/v2/subnet//read_state` for retrieving them.