GitBook: No commit message

Author: eric-stacks

docs/reference/README.md

@@ -10,7 +10,7 @@ We'll go over all the building blocks you need to be aware of to build high-qual
 
 #### Clarity
 
-[Clarity](https://app.gitbook.com/s/H74xqoobupBWwBsVMJhK/clarity/overview) is the smart contract language on Stacks. If you want to build the next decentralized social network, DeFi protocol, or any other Stacks dapp, you'll need to know Clarity.
+[Clarity](/broken/spaces/H74xqoobupBWwBsVMJhK/pages/f5e52a03a2c80c85f49f56d1684b87757fb9ec73) is the smart contract language on Stacks. If you want to build the next decentralized social network, DeFi protocol, or any other Stacks dapp, you'll need to know Clarity.
 
 #### Post Conditions
 

docs/reference/SUMMARY.md

@@ -6,7 +6,19 @@
 
 * [Stacks Node Configuration](node-operations/stacks-node-configuration.md)
 * [Signer Configuration](node-operations/signer-configuration.md)
-* [RPC API](node-operations/rpc-api.md)
+* [RPC API (old)](node-operations/rpc-api-old.md)
+* [RPC API Endpoints](node-operations/rpc-api/README.md)
+  * ```yaml
+    type: builtin:openapi
+    props:
+      models: false
+      downloadLink: false
+    dependencies:
+      spec:
+        ref:
+          kind: openapi
+          spec: stacks-blockchain-api-dereferenced
+    ```
 
 ## Clarity
 

docs/reference/node-operations/rpc-api.md …reference/node-operations/rpc-api-old.mddocs/reference/node-operations/rpc-api.md renamed to docs/reference/node-operations/rpc-api-old.md docs/reference/node-operations/rpc-api.md renamed to docs/reference/node-operations/rpc-api-old.md

@@ -1,4 +1,8 @@
-# RPC-API
+---
+hidden: true
+---
+
+# RPC API (old)
 
 ### Introduction
 

docs/reference/node-operations/rpc-api/README.md

@@ -0,0 +1,24 @@
+# RPC API Endpoints
+
+{% hint style="info" %}
+For the complete OpenAPI spec, navigate [here](https://raw.githubusercontent.com/stacks-network/stacks-core/master/docs/rpc/openapi.yaml).
+{% endhint %}
+
+The Stacks Node RPC API is exposed by every running Stacks node. It allows you to query the Stacks blockchain and interact with smart contracts. It was built to maintain pageable materialized views of the Stacks network.
+
+{% hint style="warning" %}
+If you run a local Stacks node, it exposes an HTTP server on port `20443`. The info endpoint would be `localhost:20443/v2/info`.
+{% endhint %}
+
+Note that the [Stacks Node RPC API](https://github.com/stacks-network/stacks-blockchain/) and the [Hiro Stacks Blockchain API](https://www.hiro.so/stacks-api) are two different things. The Hiro API is a centralized service run by Hiro, a developer tooling company, that makes it easy to get onboarded and begin interacting with the Stacks blockchain in a RESTful way. The Hiro API is a proxy for the Stacks Node RPC API that makes it a bit easier to work with by providing additional functionality.
+
+The Stacks Node RPC API is generated by every Stacks node and allows developers to self-host their own node and API for a more decentralized architecture.
+
+The RPC API can be used without any authorization. The basepath for the hosted API is:
+
+```bash
+# for mainnet, replace `testnet` with `mainnet`
+https://api.testnet.hiro.so/
+```
+
+The Stacks Node RPC API endpoints can also be accessed via Hiro's docs [here](https://docs.hiro.so/apis/stacks-node-rpc-api).