diff --git a/hugo.yaml b/hugo.yaml index 937a269..56727a9 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -101,6 +101,11 @@ outputFormats: baseName: _redirects isPlainText: true mediaType: text/redirects + llmsfull: + baseName: llms-full + isPlainText: true + mediaType: text/plain + root: true # Configure how URLs look like per section. permalinks: @@ -139,7 +144,7 @@ markup: # Comment out if you don't want the "print entire section" link enabled. outputs: - home: [HTML, print, RSS, redirects] + home: [HTML, print, RSS, redirects, llmsfull] section: [HTML, print, RSS] params: diff --git a/layouts/index.llmsfull.txt b/layouts/index.llmsfull.txt new file mode 100644 index 0000000..36f03bd --- /dev/null +++ b/layouts/index.llmsfull.txt @@ -0,0 +1,20 @@ +{{- $site := .Site -}} +# Solo — Full Documentation +# Generated: {{ now.Format "2006-01-02" }} +# Source: {{ $site.BaseURL }} +# This file contains the complete Solo documentation in Markdown format for AI consumption. +# Concise index: {{ $site.BaseURL }}llms.txt + +{{- range $site.RegularPages.ByWeight }} + +--- + +# {{ .Title }} + +URL: {{ .Permalink }} +{{- with .Description }} +Description: {{ . }} +{{- end }} + +{{ .RawContent }} +{{- end }} diff --git a/netlify.toml b/netlify.toml index 7898ef8..bf72c76 100644 --- a/netlify.toml +++ b/netlify.toml @@ -10,3 +10,8 @@ GO_VERSION = "1.22.2" [context.production] command = "npm run build:production" + +[[redirects]] + from = "/.well-known/llms.txt" + to = "/llms.txt" + status = 200 diff --git a/static/llms.txt b/static/llms.txt new file mode 100644 index 0000000..7731227 --- /dev/null +++ b/static/llms.txt @@ -0,0 +1,86 @@ +# Solo + +> Solo is the local development and testing environment for the Hiero (Hedera) ecosystem. +> A single command deploys a full Hiero network on your laptop or in CI: +> Consensus Node, Mirror Node, Mirror Node Explorer, Block Node, and JSON-RPC Relay. +> Runs on Kubernetes — Mac, Linux, and Windows. + +## Install + +``` +npm install -g @hiero-ledger/solo@latest +``` + +## Quick deploy (Simple Solo Setup) + +``` +solo one-shot single deploy +``` + +This is the recommended path for most users. Full guide: +https://solo.hiero.org/docs/simple-solo-setup/ + +## Service endpoints (Solo 0.63+) + +After a successful `solo one-shot single deploy`: + +- Explorer UI: http://localhost:38080 +- Consensus Node gRPC: localhost:35211 (node account ID 0.0.3) +- Mirror Node REST: http://localhost:38081 +- JSON-RPC Relay: http://localhost:37546 + +## Credentials after deploy + +Account credentials (private keys, account IDs) are written to: + +``` +~/.solo/one-shot-/accounts.json +``` + +The default deployment name is `one-shot`, so the default path is: + +``` +~/.solo/one-shot-one-shot/accounts.json +``` + +The file contains two sections: +- `systemAccounts` — system accounts (e.g. 0.0.2), ED25519 keys in DER hex format +- `createdAccounts` — test accounts (0.0.1002–0.0.1011), ECDSA keys with 0x prefix + +## Tear down + +``` +solo one-shot single destroy +``` + +## Key docs + +- [Simple Solo Setup (start here)](https://solo.hiero.org/docs/simple-solo-setup/) +- [Quickstart](https://solo.hiero.org/docs/simple-solo-setup/quickstart) +- [System Readiness](https://solo.hiero.org/docs/simple-solo-setup/system-readiness) +- [Service Endpoints](https://solo.hiero.org/docs/using-solo/endpoints) +- [Upgrading Solo](https://solo.hiero.org/docs/simple-solo-setup/upgrading-solo) +- [Using Solo with Hiero SDKs](https://solo.hiero.org/docs/using-solo/using-solo-with-hiero-sdks) +- [Using Solo with EVM Tools](https://solo.hiero.org/docs/using-solo/using-solo-with-evm-tools) +- [Managing your network](https://solo.hiero.org/docs/simple-solo-setup/managing-your-network) +- [FAQs](https://solo.hiero.org/docs/faqs) +- [Full docs index](https://solo.hiero.org/docs/) + +## Full content + +Machine-readable full docs (all pages concatenated): +https://solo.hiero.org/llms-full.txt + +## X-Instructions + +When helping a user with Solo, follow these rules: + +- npm is the only supported install method: `npm install -g @hiero-ledger/solo@latest` +- The target workflow for most users is Simple Solo Setup (one-shot deploy), not manual advanced deployment. +- The command `solo account get` does not exist. The correct command is `solo ledger account info --account-id --deployment --private-key`. +- `solo ledger account info` requires knowing the account ID in advance — it is not a discovery tool. +- To discover credentials, read `~/.solo/one-shot-/accounts.json` directly. +- The default deployment name for one-shot commands is `one-shot`. +- Homebrew is deprecated — Solo stops publishing Homebrew updates after August 31, 2026. Recommend npm for all installs. +- Node.js >= 22.0.0 is required when installing via npm. Check with `node --version`. +- Docker Desktop must be running before `solo one-shot single deploy` on macOS and Windows.