everoddandeven · Nov 7, 2026 · Nov 7, 2026 · Nov 7, 2026 · Nov 7, 2026 · Nov 7, 2026
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -0,0 +1,83 @@
+name: Docs
+
+# Builds the API site from the stubs of src/python and publishes it to GitHub Pages from main. Pull
+# requests only build it, to see that it still builds. The site is not kept in the repository.
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'docs/mkdocs/**'
+      - 'src/python/**'
+      - 'docs/architecture.png'
+      - '.github/workflows/docs.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'docs/mkdocs/**'
+      - 'src/python/**'
+      - 'docs/architecture.png'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+# A new push to a pull request cancels the previous run. Runs that are not
+# from a pull request get their own group so they are never cancelled or replaced.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: pip
+          cache-dependency-path: docs/mkdocs/requirements.in
+
+      - name: Install mkdocs and its plugins
+        run: pip install -r docs/mkdocs/requirements.in
+
+      # mkdocstrings reads the stubs without importing anything, so the module does not have to be
+      # built, but it looks for them in a folder named monero
+      - name: Lay the stubs out as the monero package
+        run: |
+          mkdir -p "$RUNNER_TEMP/stubs"
+          cp -r src/python "$RUNNER_TEMP/stubs/monero"
+          echo "MONERO_STUBS=$RUNNER_TEMP/stubs" >> "$GITHUB_ENV"
+
+      # strict, so that a docstring or a reference that does not resolve fails the build
+      - name: Build the site
+        working-directory: docs/mkdocs
+        run: mkdocs build --strict
+
+      - name: Upload the site
+        if: github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/mkdocs/public
+
+  deploy:
+    needs: build
+    if: github.event_name != 'pull_request' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-24.04
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    concurrency:
+      group: pages
+      cancel-in-progress: false
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
@@ -25,3 +25,5 @@ debian/debhelper-build-stamp
 debian/files
 debian/*.substvars
 debian/*.log
+# the site is built and published by .github/workflows/docs.yml
+docs/mkdocs/public
diff --git a/README.md b/README.md
@@ -10,15 +10,16 @@
 
 [![Pybind](https://img.shields.io/badge/pybind-v2-blue?logo=python&logoColor=white)](https://github.com/pybind/pybind11)
 [![Python](https://img.shields.io/badge/python-3.10_%7C_3.11_%7C_3.12_%7C_3.13_%7C_3.14-blue?logo=python&logoColor=white)](https://github.com/libmonero/monero-python#monero-python-library)
-[![Docs](https://img.shields.io/badge/docs-stable-blue?logo=readthedocs)](https://libmonero.github.io/monero-python/mkdocs/public/)
+[![Docs](https://img.shields.io/badge/docs-stable-blue?logo=readthedocs)](https://libmonero.github.io/monero-python/)
 [![Matrix](https://img.shields.io/badge/matrix-monero--python-blue?logo=matrix)](https://matrix.to/#/#monero-python:monero.social)
 
 A Python library for creating Monero applications using RPC and Python bindings to [monero v0.18.5.3 'Fluorine Fermi'](https://github.com/monero-project/monero/tree/v0.18.5.3).
 
 * Supports wallet and daemon RPC clients.
 * Supports client-side wallets using Python bindings.
+* Supports a keys-only wallet, which has the keys, the seed and the addresses of an account and needs no daemon.
 * Supports multisig, view-only, and offline wallets.
-* Wallet types are interchangeable by conforming to a [common interface](https://libmonero.github.io/monero-python/mkdocs/public/api/wallet/).
+* Wallet types are interchangeable by conforming to a [common interface](https://libmonero.github.io/monero-python/api/wallet/).
 * Uses a clearly defined [data model and API specification](https://github.com/libmonero/monero-python/blob/main/docs/monero-spec.pdf) intended to be intuitive and robust.
 * Query wallet transactions, transfers, and outputs by their properties.
 * Fetch and process binary data from the daemon (e.g. raw blocks).
@@ -28,7 +29,7 @@ A Python library for creating Monero applications using RPC and Python bindings
 
 <p align="center">
 	<img width="85%" height="auto" src="docs/architecture.png"/><br>
-	<i>Build Python applications using RPC or Python bindings to <a href="https://github.com/monero-project/monero">monero-project/monero</a>.  Wallet implementations are interchangeable by conforming to a common interface, <a href="https://libmonero.github.io/monero-python/mkdocs/public/api/wallet/">MoneroWallet</a>.</i>
+	<i>Build Python applications using RPC or Python bindings to <a href="https://github.com/monero-project/monero">monero-project/monero</a>.  Wallet implementations are interchangeable by conforming to a common interface, <a href="https://libmonero.github.io/monero-python/api/wallet/">MoneroWallet</a>.</i>
 </p>
 
 

diff --git a/docs/architecture.drawio b/docs/architecture.drawio
diff --git a/docs/architecture.png b/docs/architecture.png
diff --git a/docs/mkdocs/docs/en/examples/query_wallet_txs_and_transfers.md b/docs/mkdocs/docs/en/examples/query_wallet_txs_and_transfers.md
@@ -70,7 +70,7 @@ query.account_index = 1
 query.subaddress_indices = [0, 1, 2, 3]
 
 # fetch transfers that meets criteria from wallet
-transfers: list[MoneroTransferWallet] = wallet.get_transfers(query)
+transfers: list[MoneroTransfer] = wallet.get_transfers(query)
 
 # print fetched txs
 for transfer in transfers:

diff --git a/docs/mkdocs/docs/en/index.md b/docs/mkdocs/docs/en/index.md
@@ -9,7 +9,7 @@ Welcome to the Monero Python documentation.
 
 The aim of this project is to provide an intuitive and robust way to interact with the Monero cryptocurrency in Python using a clearly defined data model. It provides high level classes representing objects from the Monero environment, like wallets, accounts, addresses and transactions.
 
-Developers can create Monero applications using JSON-RPC or Python bindings to monero v0.18.5.1 'Fluorine Fermi'.
+Developers can create Monero applications using JSON-RPC or Python bindings to monero v0.18.5.3 'Fluorine Fermi'.
 
 Contributions can be made via issues and pull requests on GitHub, or communicated via the #monero-python workgroup on Matrix.
 

diff --git a/docs/mkdocs/docs/images/architecture.png b/docs/mkdocs/docs/images/architecture.png
diff --git a/docs/mkdocs/mkdocs.yml b/docs/mkdocs/mkdocs.yml
@@ -105,7 +105,7 @@ repo_url: 'https://github.com/libmonero/monero-python'
 edit_uri: edit/main/docs/mkdocs/docs/
 
 markdown_extensions:
-  # https://squidfunk.github.io/mkdocs-material/extensions/admonition/
+  # https://squidfunk.github.io/mkdocs-material/reference/admonitions/
   - admonition
   - abbr
   - def_list
@@ -140,7 +140,9 @@ plugins:
   - mkdocstrings:
       handlers:
         python:
-          paths: [../../src/python]
+          # the stubs have to sit in a folder named monero, as the package they describe. CI lays them out
+          # in a temporary folder and gives it as MONERO_STUBS, there is no need to install the module
+          paths: [!ENV [MONERO_STUBS, ../../src/python]]
           options:
             show_source: false
             show_root_heading: true

diff --git a/docs/mkdocs/public/404.html b/docs/mkdocs/public/404.html
diff --git a/docs/mkdocs/public/api/architecture/index.html b/docs/mkdocs/public/api/architecture/index.html
diff --git a/docs/mkdocs/public/api/connection/index.html b/docs/mkdocs/public/api/connection/index.html
diff --git a/docs/mkdocs/public/api/daemon/index.html b/docs/mkdocs/public/api/daemon/index.html
diff --git a/docs/mkdocs/public/api/daemon_rpc/index.html b/docs/mkdocs/public/api/daemon_rpc/index.html
diff --git a/docs/mkdocs/public/api/data_model/connection/index.html b/docs/mkdocs/public/api/data_model/connection/index.html
diff --git a/docs/mkdocs/public/api/data_model/daemon/index.html b/docs/mkdocs/public/api/data_model/daemon/index.html
diff --git a/docs/mkdocs/public/api/data_model/wallet/index.html b/docs/mkdocs/public/api/data_model/wallet/index.html
diff --git a/docs/mkdocs/public/api/errors/index.html b/docs/mkdocs/public/api/errors/index.html
diff --git a/docs/mkdocs/public/api/serializable_struct/index.html b/docs/mkdocs/public/api/serializable_struct/index.html
diff --git a/docs/mkdocs/public/api/utils/index.html b/docs/mkdocs/public/api/utils/index.html
diff --git a/docs/mkdocs/public/api/wallet/index.html b/docs/mkdocs/public/api/wallet/index.html
diff --git a/docs/mkdocs/public/api/wallet_full/index.html b/docs/mkdocs/public/api/wallet_full/index.html
diff --git a/docs/mkdocs/public/api/wallet_keys/index.html b/docs/mkdocs/public/api/wallet_keys/index.html
diff --git a/docs/mkdocs/public/api/wallet_rpc/index.html b/docs/mkdocs/public/api/wallet_rpc/index.html
diff --git a/docs/mkdocs/public/assets/_mkdocstrings.css b/docs/mkdocs/public/assets/_mkdocstrings.css