From a088f7eea2d73e9bd879699c407d4afa38f5d051 Mon Sep 17 00:00:00 2001 From: anderdc Date: Wed, 6 May 2026 14:36:58 -0500 Subject: [PATCH 1/2] agent doc: fill in deployed mainnet contract address Replace TBD/placeholder mainnet references in AgentMarkdown.ts and the hand-mirrored public/llms.txt with the deployed finney contract 5DjJmTpcHZvF3aZZEafKBdo3ksmdUSZ8bBBUSFhW3Ce3xf1J. Updates the TL;DR callout, resources table, CLI configure block, Testnet section heading, and sources-of-truth line so the doc no longer asserts mainnet is unshipped. --- public/llms.txt | 25 +++++++++++++------------ src/components/agents/AgentMarkdown.ts | 25 +++++++++++++------------ 2 files changed, 26 insertions(+), 24 deletions(-) diff --git a/public/llms.txt b/public/llms.txt index 7016d19..5ea647e 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -13,11 +13,12 @@ exchange rates. Validators verify both legs of each swap. The smart contract slashes collateral on failure and refunds the user. No custodian, no wrapped asset, no bridge token. -> **Where to point your wallets right now:** the **mainnet** contract is -> **TBD** (not yet deployed — netuid 7). All real exercise today happens -> on **testnet** (netuid 19, contract -> `5FwPheGT96iBFZ6JkwyDhDH4GcVjafWxAtSsSSq26UiYyTfg`). The full testnet -> setup block is in the **Testnet** section below. +> **Where to point your wallets right now:** **mainnet** is live on +> netuid 7 — contract `5DjJmTpcHZvF3aZZEafKBdo3ksmdUSZ8bBBUSFhW3Ce3xf1J`. +> **Testnet** is also live on netuid 19 — contract +> `5FwPheGT96iBFZ6JkwyDhDH4GcVjafWxAtSsSSq26UiYyTfg` — and is the +> recommended place to dry-run before exercising mainnet. Full setup +> blocks for both are below. ## Resources (skim these first) @@ -25,7 +26,7 @@ no wrapped asset, no bridge token. |---|---| | Live dashboard (testnet) | https://test.all-ways.io | | Testnet API + Swagger | https://test-api.all-ways.io/swagger | -| Mainnet dashboard (placeholder, contract not yet deployed) | https://all-ways.io | +| Mainnet dashboard | https://all-ways.io | | Mainnet API (placeholder) | https://api.all-ways.io | | Docs site | https://docs.all-ways.io | | Source repo | https://github.com/entrius/allways | @@ -165,15 +166,15 @@ The WIF (without `p2wpkh:`) is what you put in `BTC_PRIVATE_KEY`; the `bc1q…`/ ### 3. Configure the CLI -**Mainnet (TBD — not yet deployed):** the mainnet contract has not landed yet. Until it does, default to **testnet** for any real exercise of the system. The mainnet config shape will be: +**Mainnet (live — netuid 7):** alw config set wallet alw config set hotkey alw config set network finney alw config set netuid 7 - # contract-address: TBD — bundled in code on release + alw config set contract-address 5DjJmTpcHZvF3aZZEafKBdo3ksmdUSZ8bBBUSFhW3Ce3xf1J -**Testnet (live today):** see the Testnet section below for the full block including the testnet contract address and BTC env. For now most agents should target testnet. +**Testnet:** see the Testnet section below for the full block including the testnet contract address and BTC env. Testnet is recommended for dry-running before exercising mainnet. Config persists at `~/.allways/config.json`. @@ -373,9 +374,9 @@ live state instead of polling, and don't hammer it. - **BTC tx stuck unconfirmed → reservation timed out → BTC sent but no swap** — you broadcast with too low a fee rate for current mempool conditions, the source tx never reached 1 confirmation, validators stopped extending, and the reservation expired. When the tx eventually mines, the BTC lands in the miner's wallet with no on-chain swap to credit it against — the funds are unrecoverable. Prevention: omit `--btc-fee-rate` (let the CLI auto-estimate), or check next-block tiers on https://mempool.space before overriding. If you're already stuck pre-confirmation, RBF (replace-by-fee) up to a next-block rate immediately — recovery is only possible while the tx is still in mempool. - **Miner timed out — where's my refund?** — slashed collateral is paid in TAO to your registered swap user (coldkey for TAO source) automatically. If the on-chain transfer fails, the slash goes to a pending-claims map — run `alw claim ` (signed by your hotkey) to release it. Funds always end up at your registered user address regardless of who signs the claim. -## Testnet (the default, until mainnet ships) +## Testnet -> Mainnet is **not yet live** — until it is, all real exercise of Allways happens on testnet. Use real-fund tone (proper sender verification, fee estimation, etc.) so the muscle memory transfers, but the assets themselves are test-TAO and test-BTC. +> Testnet runs alongside mainnet and is the recommended place to dry-run swaps before exercising mainnet. Use real-fund tone (proper sender verification, fee estimation, etc.) so the muscle memory transfers, but the assets themselves are test-TAO and test-BTC. Configure the CLI for testnet: @@ -414,4 +415,4 @@ your own risk. No warranty. Not financial advice. - Repo: https://github.com/entrius/allways - Docs: https://docs.all-ways.io - Testnet UI + API: https://test.all-ways.io · https://test-api.all-ways.io/swagger -- Mainnet UI + API (placeholder until contract deploys): https://all-ways.io · https://api.all-ways.io/swagger +- Mainnet UI + API: https://all-ways.io · https://api.all-ways.io/swagger diff --git a/src/components/agents/AgentMarkdown.ts b/src/components/agents/AgentMarkdown.ts index efe74c8..45fda33 100644 --- a/src/components/agents/AgentMarkdown.ts +++ b/src/components/agents/AgentMarkdown.ts @@ -16,11 +16,12 @@ exchange rates. Validators verify both legs of each swap. The smart contract slashes collateral on failure and refunds the user. No custodian, no wrapped asset, no bridge token. -> **Where to point your wallets right now:** the **mainnet** contract is -> **TBD** (not yet deployed — netuid 7). All real exercise today happens -> on **testnet** (netuid 19, contract -> \`5FwPheGT96iBFZ6JkwyDhDH4GcVjafWxAtSsSSq26UiYyTfg\`). The full testnet -> setup block is in the **Testnet** section below. +> **Where to point your wallets right now:** **mainnet** is live on +> netuid 7 — contract \`5DjJmTpcHZvF3aZZEafKBdo3ksmdUSZ8bBBUSFhW3Ce3xf1J\`. +> **Testnet** is also live on netuid 19 — contract +> \`5FwPheGT96iBFZ6JkwyDhDH4GcVjafWxAtSsSSq26UiYyTfg\` — and is the +> recommended place to dry-run before exercising mainnet. Full setup +> blocks for both are below. ## Resources (skim these first) @@ -28,7 +29,7 @@ no wrapped asset, no bridge token. |---|---| | Live dashboard (testnet) | https://test.all-ways.io | | Testnet API + Swagger | https://test-api.all-ways.io/swagger | -| Mainnet dashboard (placeholder, contract not yet deployed) | https://all-ways.io | +| Mainnet dashboard | https://all-ways.io | | Mainnet API (placeholder) | https://api.all-ways.io | | Docs site | https://docs.all-ways.io | | Source repo | https://github.com/entrius/allways | @@ -155,15 +156,15 @@ The WIF (without \`p2wpkh:\`) is what you put in \`BTC_PRIVATE_KEY\`; the \`bc1q ### 3. Configure the CLI -**Mainnet (TBD — not yet deployed):** the mainnet contract has not landed yet. Until it does, default to **testnet** for any real exercise of the system. The mainnet config shape will be: +**Mainnet (live — netuid 7):** alw config set wallet alw config set hotkey alw config set network finney alw config set netuid 7 - # contract-address: TBD — bundled in code on release + alw config set contract-address 5DjJmTpcHZvF3aZZEafKBdo3ksmdUSZ8bBBUSFhW3Ce3xf1J -**Testnet (live today):** see the Testnet section below for the full block including the testnet contract address and BTC env. For now most agents should target testnet. +**Testnet:** see the Testnet section below for the full block including the testnet contract address and BTC env. Testnet is recommended for dry-running before exercising mainnet. Config persists at \`~/.allways/config.json\`. @@ -362,9 +363,9 @@ live state instead of polling, and don't hammer it. - **BTC tx stuck unconfirmed → reservation timed out → BTC sent but no swap** — you broadcast with too low a fee rate for current mempool conditions, the source tx never reached 1 confirmation, validators stopped extending, and the reservation expired. When the tx eventually mines, the BTC lands in the miner's wallet with no on-chain swap to credit it against — the funds are unrecoverable. Prevention: omit \`--btc-fee-rate\` (let the CLI auto-estimate), or check next-block tiers on https://mempool.space before overriding. If you're already stuck pre-confirmation, RBF (replace-by-fee) up to a next-block rate immediately — recovery is only possible while the tx is still in mempool. - **Miner timed out — where's my refund?** — slashed collateral is paid in TAO to your registered swap user (coldkey for TAO source) automatically. If the on-chain transfer fails, the slash goes to a pending-claims map — run \`alw claim \` (signed by your hotkey) to release it. Funds always end up at your registered user address regardless of who signs the claim. -## Testnet (the default, until mainnet ships) +## Testnet -> Mainnet is **not yet live** — until it is, all real exercise of Allways happens on testnet. Use real-fund tone (proper sender verification, fee estimation, etc.) so the muscle memory transfers, but the assets themselves are test-TAO and test-BTC. +> Testnet runs alongside mainnet and is the recommended place to dry-run swaps before exercising mainnet. Use real-fund tone (proper sender verification, fee estimation, etc.) so the muscle memory transfers, but the assets themselves are test-TAO and test-BTC. Configure the CLI for testnet: @@ -403,5 +404,5 @@ your own risk. No warranty. Not financial advice. - Repo: https://github.com/entrius/allways - Docs: https://docs.all-ways.io - Testnet UI + API: https://test.all-ways.io · https://test-api.all-ways.io/swagger -- Mainnet UI + API (placeholder until contract deploys): https://all-ways.io · https://api.all-ways.io/swagger +- Mainnet UI + API: https://all-ways.io · https://api.all-ways.io/swagger `; From 1259f232f72410e1650c53c60c9e58d6c74b5228 Mon Sep 17 00:00:00 2001 From: anderdc Date: Wed, 6 May 2026 14:43:35 -0500 Subject: [PATCH 2/2] =?UTF-8?q?agent=20doc:=20drop=20(placeholder)=20on=20?= =?UTF-8?q?Mainnet=20API=20row=20=E2=80=94=20api.all-ways.io=20is=20live?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- public/llms.txt | 2 +- src/components/agents/AgentMarkdown.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/public/llms.txt b/public/llms.txt index 5ea647e..e37ea7b 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -27,7 +27,7 @@ no wrapped asset, no bridge token. | Live dashboard (testnet) | https://test.all-ways.io | | Testnet API + Swagger | https://test-api.all-ways.io/swagger | | Mainnet dashboard | https://all-ways.io | -| Mainnet API (placeholder) | https://api.all-ways.io | +| Mainnet API + Swagger | https://api.all-ways.io/swagger | | Docs site | https://docs.all-ways.io | | Source repo | https://github.com/entrius/allways | | This document, raw | https://all-ways.io/llms.txt (mirrored at https://test.all-ways.io/llms.txt) | diff --git a/src/components/agents/AgentMarkdown.ts b/src/components/agents/AgentMarkdown.ts index 45fda33..88a66f8 100644 --- a/src/components/agents/AgentMarkdown.ts +++ b/src/components/agents/AgentMarkdown.ts @@ -30,7 +30,7 @@ no wrapped asset, no bridge token. | Live dashboard (testnet) | https://test.all-ways.io | | Testnet API + Swagger | https://test-api.all-ways.io/swagger | | Mainnet dashboard | https://all-ways.io | -| Mainnet API (placeholder) | https://api.all-ways.io | +| Mainnet API + Swagger | https://api.all-ways.io/swagger | | Docs site | https://docs.all-ways.io | | Source repo | https://github.com/entrius/allways | | This document, raw | https://all-ways.io/llms.txt (mirrored at https://test.all-ways.io/llms.txt) |