Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

docs: add x402 VS Code guide for THREE

nirholasd175ef3603fe
diff --git a/README.md b/README.md
index be3b1390e..ab4da2a8a 100644
--- a/README.md
+++ b/README.md
@@ -10311,6 +10311,8 @@ The same five tools ship over two transports: **stdio** (`npx @three-ws/ibm-x402
three.ws is a first-class [x402](https://x402.org) host. Agents can both **pay for** and **expose** paid endpoints. Settlement runs on Base, BSC, and Solana; the bazaar at [three.ws/x402](https://three.ws/x402) is the discovery surface.
+The [x402 extension for VS Code](https://marketplace.visualstudio.com/items?itemName=threews.vscode-x402) brings that flow into the editor: browse the Bazaar, inspect a 402 challenge, and pay with **$THREE or USDC on Solana**. The $THREE contract address is `FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`. The [setup guide](https://three.ws/docs/x402-vscode) covers secure wallet storage, token selection, confirmation, and settlement receipts.
+
**Public proof:** the server is [listed on x402scan](https://www.x402scan.com/server/17cbd874-52ac-4920-a020-b22ff2489a07) with its paid tool calls and revenue, and [three.ws/pulse](https://three.ws/pulse) renders every settled agent-to-agent payment as it lands on-chain (hundreds of x402 settlements per day, live counters, real events only).
### Payment rails
diff --git a/data/pages.json b/data/pages.json
index fbce2ec0b..e615d4b07 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -3621,6 +3621,14 @@
"description": "How three.ws implements x402 HTTP 402 paid agent skills: the challenge, verify, and settle mechanics.",
"added": "2026-04-29"
},
+ {
+ "path": "/docs/x402-vscode",
+ "title": "Docs · x402 for VS Code",
+ "description": "Find, inspect, and pay x402 APIs from VS Code with $THREE or USDC on Solana, including wallet setup, token selection, safety controls, and the $THREE contract address.",
+ "priority": 0.8,
+ "changefreq": "monthly",
+ "added": "2026-09-13"
+ },
{
"path": "/docs/premium",
"title": "Premium Pass: Monthly Data API Access",
diff --git a/docs/vscode.md b/docs/vscode.md
index 204a5d21e..8d6c9f154 100644
--- a/docs/vscode.md
+++ b/docs/vscode.md
@@ -2,8 +2,9 @@
Two extensions put the platform inside the editor. **three.ws 3D** makes model
files, 3D generation, animation, and embedding native to VS Code. **three.ws
-x402** does the same for paid endpoints. This page covers the first; see
-[x402](./x402.md#open-source-packages) for the second.
+x402** does the same for paid endpoints. It pays with $THREE on Solana at
+`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`. This page covers the first;
+see [x402 for VS Code](./x402-vscode.md) for the second.
| | |
|---|---|
diff --git a/docs/x402-vscode.md b/docs/x402-vscode.md
new file mode 100644
index 000000000..6ac091760
--- /dev/null
+++ b/docs/x402-vscode.md
@@ -0,0 +1,106 @@
+# x402 for VS Code
+
+The three.ws x402 extension lets you find, inspect, and pay paid APIs from VS
+Code. It supports **$THREE or USDC on Solana**, plus **USDC on Base** and other
+EVM chains. Wallet keys stay in VS Code SecretStorage, backed by your operating
+system keychain.
+
+- [Install from the VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=threews.vscode-x402)
+- [View source and releases](https://github.com/nirholas/vscode-x402)
+- [Browse the three.ws x402 Bazaar](/bazaar)
+
+## Pay with $THREE
+
+The extension can settle an x402 `exact` payment with the three.ws ecosystem
+token when a service advertises it in its 402 challenge.
+
+| Field | Value |
+|---|---|
+| Symbol | `$THREE` |
+| Network | Solana |
+| Contract address | `FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump` |
+| Preference setting | `x402.preferToken: "three"` |
+| Payment scheme | `@x402/svm` exact |
+
+The mint must match the contract address above. The extension shows the amount
+in $THREE, the network, paying wallet, and recipient before signing. It always
+requires explicit confirmation for $THREE because an x402 challenge does not
+include a trusted fiat conversion.
+
+## Install
+
+Install from the Marketplace:
+
+```bash
+code --install-extension threews.vscode-x402
+```
+
+If the Marketplace still shows a version earlier than 0.2.0, install the newest
+VSIX from [GitHub Releases](https://github.com/nirholas/vscode-x402/releases)
+to get Solana and $THREE support.
+
+## Configure Solana
+
+1. Open VS Code and run **x402: Set Solana Wallet Key** from the command palette.
+2. Enter a funded Solana secret key as base58 or a JSON byte array.
+3. Open Settings and set `x402.bazaarUrl` to `https://three.ws`.
+4. Set `x402.preferToken` to `three`.
+5. Open the **x402 Bazaar** activity bar view, inspect a service, and select
+ **Pay & call**.
+
+A complete settings block looks like this:
+
+```json
+{
+ "x402.bazaarUrl": "https://three.ws",
+ "x402.network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+ "x402.preferToken": "three",
+ "x402.maxPaymentUsd": 0.1,
+ "x402.confirmEachPayment": true
+}
+```
+
+The extension only pays with $THREE when the endpoint offers the exact $THREE
+mint. If it does not, the endpoint remains visible and its other accepted
+payment options are shown.
+
+## Inspect before paying
+
+The extension separates free inspection from payment:
+
+1. It requests the endpoint and decodes the `402 Payment Required` response.
+2. It lists each accepted network, token, amount, scheme, and recipient.
+3. It selects a requirement your configured wallet can satisfy.
+4. It asks for confirmation.
+5. It signs the payment proof, retries the request once, and renders the response
+ with the settlement transaction hash.
+
+Browsing the Bazaar and inspecting challenges do not spend funds. A payment is
+signed only after the confirmation step.
+
+## Supported rails
+
+| Rail | Tokens | Wallet command |
+|---|---|---|
+| Solana | $THREE and USDC | **x402: Set Solana Wallet Key** |
+| EVM | USDC | **x402: Set EVM Wallet Key** |
+
+When an endpoint accepts several options, `x402.network` and
+`x402.preferToken` determine which eligible requirement wins. The default
+selection prefers Solana USDC, then Base. Set `x402.preferToken` to `three`
+to put $THREE first.
+
+## Security
+
+- Solana and EVM private keys are stored separately in VS Code SecretStorage.
+- Private keys are never written to workspace settings.
+- $THREE payments always require explicit confirmation.
+- USDC payments above `x402.maxPaymentUsd` are blocked before signing.
+- An endpoint that cannot be paid by a configured wallet is clearly marked.
+
+## Related
+
+- [x402 protocol on three.ws](x402.md)
+- [x402 paid endpoints](x402-endpoints.md)
+- [x402 buyer client](x402-buyer.md)
+- [three.ws in VS Code](vscode.md)
diff --git a/docs/x402.md b/docs/x402.md
index 7c0f8f499..049f6b664 100644
--- a/docs/x402.md
+++ b/docs/x402.md
@@ -162,6 +162,18 @@ Each package has its own repository with a full README, API reference, and examp
[ibm-x402-mcp](https://github.com/nirholas/ibm-x402-mcp) ·
[vscode-x402](https://github.com/nirholas/vscode-x402).
+### $THREE payments from VS Code
+
+The VS Code extension pays x402 challenges with **$THREE or USDC on Solana**.
+The $THREE contract address is
+`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`. Set
+`x402.preferToken` to `three` to select it whenever an endpoint advertises
+that exact mint. Every $THREE payment shows the token amount, network, paying
+wallet, and recipient, then requires explicit confirmation before signing.
+
+See [x402 for VS Code](x402-vscode.md) for installation, wallet setup, settings,
+and the payment flow.
+
## Tutorials
- [Pay for an x402 service](tutorials/pay-for-x402-service.md) — settle a paid request end to end with `@three-ws/x402-fetch`.
diff --git a/packages/vscode-x402/README.md b/packages/vscode-x402/README.md
index e7e330bfc..48c4a8766 100644
--- a/packages/vscode-x402/README.md
+++ b/packages/vscode-x402/README.md
@@ -9,6 +9,21 @@ x402 is a protocol for developers and agents, not end users, so unlike a 3D
viewer this is genuinely editor-native: the people wiring up paid endpoints and
calling them live in VS Code.
+## Pay with $THREE on Solana
+
+Set `threewsX402.preferToken` to `three` to prefer endpoints that accept the
+three.ws ecosystem token.
+
+- **Symbol:** `$THREE`
+- **Network:** Solana
+- **Contract address:** `FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`
+- **Payment scheme:** x402 `exact` through `@x402/svm`
+
+The extension only selects $THREE when the endpoint advertises that exact mint
+in its 402 challenge. It shows the amount, network, paying address, and
+recipient, then requires explicit confirmation before signing. Read the full
+[x402 for VS Code guide](https://three.ws/docs/x402-vscode).
+
## Features
- **Bazaar sidebar** — live list of paid x402 HTTP APIs and MCP tools, merged