diff --git a/README.md b/README.md index 086478f..347c45e 100644 --- a/README.md +++ b/README.md @@ -74,5 +74,5 @@ Ready to build? Start here: * [Quickstart for Sellers](getting-started/quickstart-for-sellers.md) * [Quickstart for Buyers](getting-started/quickstart-for-buyers.md) -* [Explore Core Concepts](broken-reference) +* [Explore Core Concepts](core-concepts/README.md) * [Join our community on Discord](https://discord.gg/invite/cdp) diff --git a/core-concepts/README.md b/core-concepts/README.md new file mode 100644 index 0000000..297ba80 --- /dev/null +++ b/core-concepts/README.md @@ -0,0 +1,14 @@ +# Core Concepts + +x402 relies on a few foundational ideas that work together to enable permissionless, usage-based payments over HTTP. This section introduces each component at a high level and links to the detailed guides. + +## Key Building Blocks + +- **[HTTP 402](http-402.md):** How x402 uses the `402 Payment Required` status code to negotiate payment before a response is returned. +- **[Client / Server](client-server.md):** The buyer and seller responsibilities during the payment handshake. +- **[Facilitator](facilitator.md):** The service that verifies and settles payments on behalf of sellers. +- **[Wallet](wallet.md):** How buyers manage the credentials and funds needed to send payments. +- **[Bazaar (Discovery Layer)](bazaar-discovery-layer.md):** A marketplace pattern for publishing and discovering x402-compatible services. +- **[Network & Token Support](network-and-token-support.md):** Supported chains, assets, and settlement schemes today. + +Use these chapters to understand how x402 fits together before diving into implementation specifics.