From 4b58c5e0e3179a6b3b8947e05637002c78e2b422 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 13:32:22 -0800
Subject: [PATCH 01/22] update default bitcoin node in sample configs

---
 reference/sample-configuration-files.md | 6 +-----
 reference/stacks-node-configuration.md  | 3 ---
 2 files changed, 1 insertion(+), 8 deletions(-)

diff --git a/reference/sample-configuration-files.md b/reference/sample-configuration-files.md
index 70a27e8267..4bb7804505 100644
--- a/reference/sample-configuration-files.md
+++ b/reference/sample-configuration-files.md
@@ -216,11 +216,7 @@ stacker = true
 [burnchain]
 chain = "bitcoin"
 mode = "mainnet"
-peer_host = "bitcoind.stacks.co"
-username = "blockstack"
-password = "blockstacksystem"
-rpc_port = 8332
-peer_port = 8333
+peer_host = "bitcoin.mainnet.stacks.org"
 
 # Set your auth token, which the signer uses
 # This should match the auth_password field of your signer config
diff --git a/reference/stacks-node-configuration.md b/reference/stacks-node-configuration.md
index e481da53f8..6db2d120d9 100644
--- a/reference/stacks-node-configuration.md
+++ b/reference/stacks-node-configuration.md
@@ -140,9 +140,6 @@ bootstrap_node = "02196f005965cebe6ddc3901b7b1cc1aa7a88f305bb8c5893456b8f9a60592
 chain = "bitcoin"
 mode = "mainnet"
 peer_host = "localhost"
-username = "user"
-password = "pass"
-rpc_port = 8332
 peer_port = 8333
 
 [[events_observer]]

From 552b018ab5ed87a9b411c79c18067abefedd4542 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 13:41:50 -0800
Subject: [PATCH 02/22] test removing swagger links for reference/api

---
 reference/api.md | 47 -----------------------------------------------
 1 file changed, 47 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index 0209b9476a..4225b1d82d 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,50 +29,3 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/map_entry/{contract_address}/{contract_name}/{map_name}" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/source/{contract_address}/{contract_name}" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/call-read/{contract_address}/{contract_name}/{function_name}" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/accounts/{principal}" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/fees/transaction" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/fees/transfer" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/info" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/pox" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/traits/{contract_address}/{contract_name}/{trait_contract_address}/{trait_contract_name}/{trait_name}" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/constant_val/{contract_address}/{contract_name}/{constant_name}" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}

From ff816f9d06ce4edea75793a3539390d3e7f77e20 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 14:05:15 -0800
Subject: [PATCH 03/22] add swagger link

---
 reference/api.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/api.md b/reference/api.md
index 4225b1d82d..43d93db900 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,3 +29,7 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}
+

From 19c7c774840c87eef8ad8282da36e448b773ab15 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 14:09:50 -0800
Subject: [PATCH 04/22] add more swagger link for testing

---
 reference/api.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/reference/api.md b/reference/api.md
index 43d93db900..7d935d82a2 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,3 +33,6 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}

From fbd915309d5bb191dbd792a609bcf6dfc56272ee Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 14:11:28 -0800
Subject: [PATCH 05/22] add more swagger link for testing

---
 reference/api.md | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index 7d935d82a2..43d93db900 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,6 +33,3 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}

From 1334614619dca163363212f76d3338f3aad5786d Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 14:12:53 -0800
Subject: [PATCH 06/22] add more swagger link for testing

---
 reference/api.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/reference/api.md b/reference/api.md
index 43d93db900..aa0f74246c 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,3 +33,6 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/map_entry/{contract_address}/{contract_name}/{map_name}" method="post" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}

From 6fb575d0cfe7759e5033a2363bb377581d126986 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:09:31 -0800
Subject: [PATCH 07/22] add more swagger link for testing

---
 reference/api.md | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index aa0f74246c..8292717d7b 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,10 +29,7 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml){% endswagger %}
+
+{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %} [https://api.gitbook.com/openapi.json](test 1) {% endswagger %}
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/map_entry/{contract_address}/{contract_name}/{map_name}" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}

From da9de03c4c75c71983003b3d6c0d44a9f7770299 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:11:38 -0800
Subject: [PATCH 08/22] add more swagger link for testing

---
 reference/api.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/api.md b/reference/api.md
index 8292717d7b..8d54ada71a 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,3 +33,4 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %} [https://api.gitbook.com/openapi.json](test 1) {% endswagger %}
 
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml){% endswagger %}

From ca204f0cd8e77c68face767b2974b221fd7d1fce Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:12:44 -0800
Subject: [PATCH 09/22] add more swagger link for testing

---
 reference/api.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/api.md b/reference/api.md
index 8d54ada71a..65c6e33f28 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,4 +33,6 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %} [https://api.gitbook.com/openapi.json](test 1) {% endswagger %}
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml){% endswagger %}
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/constant_val/{contract_address}/{contract_name}/{constant_name}" method="post" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}

From ee3197c277e5e5c0f50a5483d858a47aa50dfc2d Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:14:04 -0800
Subject: [PATCH 10/22] add more swagger link for testing

---
 reference/api.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/api.md b/reference/api.md
index 65c6e33f28..8bf85b0c0e 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,6 +33,7 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %} [https://api.gitbook.com/openapi.json](test 1) {% endswagger %}
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/constant_val/{contract_address}/{contract_name}/{constant_name}" method="post" %}
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/pox" method="get" %}
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
+

From 49a5f7e64dee1907ae9e4550fa579bcbb3b57d2f Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:15:22 -0800
Subject: [PATCH 11/22] add more swagger link for testing

---
 reference/api.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index 8bf85b0c0e..064bd3be48 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,11 +29,10 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml){% endswagger %}
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/info" method="get" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %} [https://api.gitbook.com/openapi.json](test 1) {% endswagger %}
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/pox" method="get" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
 

From 016b4f9c7809bb2c62b2615fd0e8265a773bafdb Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:17:29 -0800
Subject: [PATCH 12/22] add more swagger link for testing

---
 reference/api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/api.md b/reference/api.md
index 064bd3be48..0ee3d1711b 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,7 +29,7 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/info" method="get" %}
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 

From 6bfd960f5df33fb43317ab6e7e712591f0ee1768 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:18:31 -0800
Subject: [PATCH 13/22] add more swagger link for testing

---
 reference/api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/api.md b/reference/api.md
index 0ee3d1711b..e64acf6bbd 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,7 +29,7 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 

From bbcee29a33ba3eb002318364a9ce5e1b6a2a9dd6 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:21:13 -0800
Subject: [PATCH 14/22] add more swagger link for testing

---
 reference/api.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/api.md b/reference/api.md
index e64acf6bbd..4ef28e120a 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,6 +33,10 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}
+
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %} [https://api.gitbook.com/openapi.json](test 1) {% endswagger %}
 
 

From e82b5daf585e6dde5a691c8fcd73d3fcabf6bc4e Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:22:35 -0800
Subject: [PATCH 15/22] add more swagger link for testing

---
 reference/api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/api.md b/reference/api.md
index 4ef28e120a..b0edf02030 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -33,7 +33,7 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/fees/transaction" method="post" %}
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 

From 51c68178fce07f07c67a326aa3d00ba5732354d4 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:24:51 -0800
Subject: [PATCH 16/22] add more swagger link for testing

---
 reference/api.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/api.md b/reference/api.md
index b0edf02030..6740b90927 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -32,7 +32,6 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 {% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
-
 {% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/fees/transaction" method="post" %}
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}

From b8b46a2caceaaa63fb07444d549b3480132b372b Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:34:53 -0800
Subject: [PATCH 17/22] add more swagger link for testing

---
 reference/api.md | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index 6740b90927..1604ad2d0c 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,13 +29,18 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/fees/transaction" method="post" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
+GET a specific space
+{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}" method="get" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
 
-{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %} [https://api.gitbook.com/openapi.json](test 1) {% endswagger %}
+GET permissions for all users in a space
+{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}/permissions/aggregate" method="get" %} https://api.gitbook.com/openapi.json {% endswagger %}
 
+POST a new space in an organization
+{% swagger src="https://api.gitbook.com/openapi.json" path="/orgs/{organizationId}/spaces" method="post" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
+
+POST a duplicate of a space
+{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}/duplicate" method="post" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
+
+UPDATE a specific space
+{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}" method="patch" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
 

From 7d9d0882dd44f3710572b6ed688bdb157a2d6018 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:45:58 -0800
Subject: [PATCH 18/22] add more swagger link for testing

---
 reference/api.md | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index 1604ad2d0c..b6cfb0c287 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,18 +29,24 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-GET a specific space
-{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}" method="get" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
+### `GET` a specific collection
 
-GET permissions for all users in a space
-{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}/permissions/aggregate" method="get" %} https://api.gitbook.com/openapi.json {% endswagger %}
+{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %}
+[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
+{% endswagger %}
 
-POST a new space in an organization
-{% swagger src="https://api.gitbook.com/openapi.json" path="/orgs/{organizationId}/spaces" method="post" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
+### `GET` spaces in a collection
 
-POST a duplicate of a space
-{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}/duplicate" method="post" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
+{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}/spaces" method="get" %}
+[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
+{% endswagger %}
 
-UPDATE a specific space
-{% swagger src="https://api.gitbook.com/openapi.json" path="/spaces/{spaceId}" method="patch" expanded="true" %} https://api.gitbook.com/openapi.json {% endswagger %}
+{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %}
+[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
+{% endswagger %}
 
+### `GET` permissions for all users in a collection
+
+{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}/permissions/aggregate" method="get" expanded="true" %}
+[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
+{% endswagger %}

From 96fddf4bc5a9a474d97b203fd98a6d2ac2d2c157 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:52:17 -0800
Subject: [PATCH 19/22] add more swagger link for testing

---
 reference/api.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index b6cfb0c287..37617403dd 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,13 +29,19 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-### `GET` a specific collection
+#### /v2/transactions
+
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" expanded="true" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}
+
+#### `GET` a specific collection
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %}
 [https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
 {% endswagger %}
 
-### `GET` spaces in a collection
+#### `GET` spaces in a collection
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}/spaces" method="get" %}
 [https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
@@ -45,7 +51,7 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 [https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
 {% endswagger %}
 
-### `GET` permissions for all users in a collection
+#### `GET` permissions for all users in a collection
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}/permissions/aggregate" method="get" expanded="true" %}
 [https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)

From efbfdfb59064ce680e654388d56f2a1413e00a54 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 17:53:42 -0800
Subject: [PATCH 20/22] add more swagger link for testing

---
 reference/api.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/api.md b/reference/api.md
index 37617403dd..27149c9c00 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -35,6 +35,12 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
 {% endswagger %}
 
+#### /v2/contracts/interface/{contract_address}/{contract_name}
+
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" expanded="true" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+{% endswagger %}
+
 #### `GET` a specific collection
 
 {% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %}

From 2c2da92cbd7b4f150f12aa846dd54e25b98e8827 Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Fri, 31 Jan 2025 18:02:24 -0800
Subject: [PATCH 21/22] add more swagger link for testing

---
 reference/api.md | 29 +----------------------------
 1 file changed, 1 insertion(+), 28 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index 27149c9c00..02c5eb431f 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -29,36 +29,9 @@ If you run a local node, it exposes an HTTP server on port `20443`. The info end
 
 The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every running Stacks node exposes an RPC API, which allows you to interact with the underlying blockchain. Instead of using a centrally hosted API, you can directly access the RPC API of a locally hosted Node.
 
-#### /v2/transactions
-
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" expanded="true" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
 
 #### /v2/contracts/interface/{contract_address}/{contract_name}
 
 {% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" expanded="true" %}
 [https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
-{% endswagger %}
-
-#### `GET` a specific collection
-
-{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %}
-[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
-{% endswagger %}
-
-#### `GET` spaces in a collection
-
-{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}/spaces" method="get" %}
-[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
-{% endswagger %}
-
-{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}" method="get" expanded="true" %}
-[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
-{% endswagger %}
-
-#### `GET` permissions for all users in a collection
-
-{% swagger src="https://api.gitbook.com/openapi.json" path="/collections/{collectionId}/permissions/aggregate" method="get" expanded="true" %}
-[https://api.gitbook.com/openapi.json](https://api.gitbook.com/openapi.json)
-{% endswagger %}
+{% endswagger %}
\ No newline at end of file

From 53c6969ed129505bb377827b74e6b18830c1967a Mon Sep 17 00:00:00 2001
From: wileyj <2847772+wileyj@users.noreply.github.com>
Date: Mon, 3 Feb 2025 09:29:35 -0800
Subject: [PATCH 22/22] test 2.4

---
 reference/api.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/reference/api.md b/reference/api.md
index 02c5eb431f..d591e9e444 100644
--- a/reference/api.md
+++ b/reference/api.md
@@ -32,6 +32,19 @@ The Stacks 2.0 Blockchain API (Hiro's API) is centrally hosted. However, every r
 
 #### /v2/contracts/interface/{contract_address}/{contract_name}
 
-{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" expanded="true" %}
-[https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml)
+
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml" path="/v2/transactions" method="post" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml)
+{% endswagger %}
+
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml" path="/v2/contracts/interface/{contract_address}/{contract_name}" method="get" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml)
+{% endswagger %}
+
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml" path="/v2/map_entry/{contract_address}/{contract_name}/{map_name}" method="post" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml)
+{% endswagger %}
+
+{% swagger src="https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml" path="/v2/contracts/source/{contract_address}/{contract_name}" method="get" %}
+[https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml](https://raw.githubusercontent.com/stacks-network/stacks-core/refs/tags/2.4.0.1.0/docs/rpc/openapi.yaml)
 {% endswagger %}
\ No newline at end of file