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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs: add x402 VS Code guide for THREE
nirholasd175ef3603fe
diff --git a/README.md b/README.mdindex 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-x402three.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 railsdiff --git a/data/pages.json b/data/pages.jsonindex 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.mdindex 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 modelfiles, 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.mdnew file mode 100644index 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.mdindex 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.mdindex 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 3Dviewer this is genuinely editor-native: the people wiring up paid endpoints andcalling 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