kaspanet · smartgoo · May 2, 2026 · May 2, 2026
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 0.2
+---
+
 ## [Unreleased]
 
 ### Added
@@ -29,7 +34,7 @@
 - `pyproject.toml`: set `python-source = "python"` and moved the package stub tree under `python/kaspa/` (`kaspa.pyi` → `python/kaspa/__init__.pyi`).
 - `Hash` accepts `str` in addition to `Hash` instances wherever it is used as an argument, and gained a `to_hex()` method.
 - Added `__repr__` methods to: `Hash`, `Balance`, `Binary`, `Address`, `NetworkId`, `ScriptPublicKey`, `TransactionOutpoint`, `Transaction`, `TransactionInput`, `TransactionOutput`, `UtxoEntry`, `UtxoEntries` (consensus and generator helper), `UtxoEntryReference`, `ScriptBuilder`, `Wallet`, `Fees`, `PaymentOutput`, `Outputs`, `Generator`, `GeneratorSummary`, `PendingTransaction`, `BalanceStrings`, `UtxoProcessorEvent`, `UtxoProcessor`, `UtxoContext`, `Notification`, `Resolver`, `NotificationEvent`, `RpcClient`, `DerivationPath`, `XPub`, `PublicKey`, `XOnlyPublicKey`, `PublicKeyGenerator`.
-- Documentation site reorganization
+- Documentation site reorganization & search ranking
 
 ### Fixed
 - `AccountDescriptor.__repr__` now correctly renders optional fields.

diff --git a/docs/examples.md b/docs/examples.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Examples
 
 Runnable examples live in the SDK repository, not in these docs. Each

diff --git a/docs/gen_ref_pages.py b/docs/gen_ref_pages.py
@@ -19,6 +19,23 @@
     "Exceptions",
 ]
 
+CLASS_BOOSTS = {
+    "Wallet": 10,
+    "RpcClient": 8,
+    "Address": 8,
+    "Transaction": 8,
+    "Generator": 6,
+    "UtxoEntry": 5,
+    "PublicKey": 5,
+    "PrivateKey": 5,
+    "Mnemonic": 5,
+    "UtxoProcessor": 5,
+    "UtxoContext": 5,
+    "Resolver": 4,
+    "ScriptBuilder": 4,
+    "NetworkId": 4,
+}
+
 
 def parse_stub_file(content: str) -> dict:
     """
@@ -161,6 +178,10 @@ def category_to_nav_path(category: str) -> tuple:
             with mkdocs_gen_files.open(doc_path, "w") as f:
                 if category == "Exceptions":
                     f.write("---\nsearch:\n  boost: 0.3\n---\n\n")
+                elif category == "TypedDicts":
+                    f.write("---\nsearch:\n  boost: 0.6\n---\n\n")
+                elif name in CLASS_BOOSTS:
+                    f.write(f"---\nsearch:\n  boost: {CLASS_BOOSTS[name]}\n---\n\n")
                 f.write(f'# `{name}` ({type_label})\n\n')
                 f.write(f"::: {module}.{name}\n")
                 f.write("    options:\n")

diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Installation
 
 This Python package can be [installed from PyPi](#installation-via-pypi) or [built from source](#installation-from-source). 

diff --git a/docs/getting-started/security.md b/docs/getting-started/security.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Security
 
 The SDK gives you direct access to mnemonics, seeds, private keys, and wallet

diff --git a/docs/learn/addresses.md b/docs/learn/addresses.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Addresses
 
 A Kaspa address encodes a public key or script hash, the address

diff --git a/docs/learn/index.md b/docs/learn/index.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Learn
 
 The Learn section on this site is grouped into the following main categories:

diff --git a/docs/learn/networks.md b/docs/learn/networks.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Networks
 
 The Kaspa community runs various public networks: a production mainnet and a few testnets.

diff --git a/docs/learn/rpc/calls.md b/docs/learn/rpc/calls.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Calls
 
 Once connected, every RPC method is `await client.<name>(...)`. Most

diff --git a/docs/learn/rpc/connecting.md b/docs/learn/rpc/connecting.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Connecting
 
 [`RpcClient.connect()`](../../reference/Classes/RpcClient.md#kaspa.RpcClient.connect)

diff --git a/docs/learn/rpc/overview.md b/docs/learn/rpc/overview.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 5
+---
+
 # RPC
 
 Kaspa nodes expose an RPC API. This SDK provides

diff --git a/docs/learn/rpc/resolver.md b/docs/learn/rpc/resolver.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Resolver
 
 A [`Resolver`](../../reference/Classes/Resolver.md) finds a public Kaspa

diff --git a/docs/learn/rpc/subscriptions.md b/docs/learn/rpc/subscriptions.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Subscriptions
 
 Subscriptions let

diff --git a/docs/learn/transactions/inputs.md b/docs/learn/transactions/inputs.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Inputs
 
 A transaction's inputs say *which UTXOs are being spent*. Each input

diff --git a/docs/learn/transactions/mass-and-fees.md b/docs/learn/transactions/mass-and-fees.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Mass & fees
 
 Kaspa uses a **mass-based fee model**. Every transaction has a *mass*

diff --git a/docs/learn/transactions/metadata.md b/docs/learn/transactions/metadata.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Metadata fields
 
 Beyond inputs and outputs, a

diff --git a/docs/learn/transactions/outputs.md b/docs/learn/transactions/outputs.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Outputs
 
 A transaction's outputs are the new UTXOs it creates. Each carries a

diff --git a/docs/learn/transactions/overview.md b/docs/learn/transactions/overview.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 5
+---
+
 # Transactions
 
 A Kaspa transaction has the same shape as on any UTXO chain: a list

diff --git a/docs/learn/transactions/scripts.md b/docs/learn/transactions/scripts.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Scripts
 
 A [`ScriptPublicKey`](../../reference/Classes/ScriptPublicKey.md) is the lock on every output. Most of the time it's

diff --git a/docs/learn/transactions/serialization.md b/docs/learn/transactions/serialization.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Serialization
 
 The transaction-shaped types —

diff --git a/docs/learn/transactions/signing.md b/docs/learn/transactions/signing.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Signing
 
 Signing fills each input's `signature_script` with proof that the

diff --git a/docs/learn/transactions/submission.md b/docs/learn/transactions/submission.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Submission & confirmation
 
 Submitting a signed transaction hands it to a node, which gossips it

diff --git a/docs/learn/wallet-sdk/derivation.md b/docs/learn/wallet-sdk/derivation.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Derivation
 
 Once you have an [`XPrv`](../../reference/Classes/XPrv.md) (see

diff --git a/docs/learn/wallet-sdk/key-management.md b/docs/learn/wallet-sdk/key-management.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Key Management
 
 Everything on this page is BIP-39 compatible. The SDK gives you

diff --git a/docs/learn/wallet-sdk/overview.md b/docs/learn/wallet-sdk/overview.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 5
+---
+
 # Wallet SDK
 
 The **Wallet SDK** is the set of primitives the managed

diff --git a/docs/learn/wallet-sdk/tx-generator.md b/docs/learn/wallet-sdk/tx-generator.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Transaction Generator
 
 The [`Generator`](../../reference/Classes/Generator.md) is the SDK's

diff --git a/docs/learn/wallet-sdk/utxo-context.md b/docs/learn/wallet-sdk/utxo-context.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # UTXO Context
 
 A [`UtxoContext`](../../reference/Classes/UtxoContext.md) tracks UTXOs

diff --git a/docs/learn/wallet-sdk/utxo-processor.md b/docs/learn/wallet-sdk/utxo-processor.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # UTXO Processor
 
 A [`UtxoProcessor`](../../reference/Classes/UtxoProcessor.md) is the

diff --git a/docs/learn/wallet/accounts.md b/docs/learn/wallet/accounts.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Accounts
 
 A wallet can hold multiple accounts of mixed kinds, each backed by one

diff --git a/docs/learn/wallet/addresses.md b/docs/learn/wallet/addresses.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Addresses
 
 A BIP32 account derives [`Address`](../../reference/Classes/Address.md) instances. The wallet records two

diff --git a/docs/learn/wallet/architecture.md b/docs/learn/wallet/architecture.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Architecture
 
 The `Wallet` class is a system of cooperating components. Knowing some of the underlying mechanics is useful for development.

diff --git a/docs/learn/wallet/errors.md b/docs/learn/wallet/errors.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Errors
 
 The wallet's errors live in `kaspa.exceptions`. Most are

diff --git a/docs/learn/wallet/events.md b/docs/learn/wallet/events.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Events
 
 The wallet emits events for every state change the node pushes

diff --git a/docs/learn/wallet/lifecycle.md b/docs/learn/wallet/lifecycle.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Lifecycle
 
 A `Wallet` moves through five states. Each transition is async and

diff --git a/docs/learn/wallet/overview.md b/docs/learn/wallet/overview.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 5
+---
+
 # Wallet
 
 The [`Wallet`](../../reference/Classes/Wallet.md) class is the SDK's

diff --git a/docs/learn/wallet/private-keys.md b/docs/learn/wallet/private-keys.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Private Keys
 
 A *private key data* entry is the encrypted secret that backs one or

diff --git a/docs/learn/wallet/send-transaction.md b/docs/learn/wallet/send-transaction.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Send Transaction
 
 Outgoing flows from an activated account. Every method on this page

diff --git a/docs/learn/wallet/sweep.md b/docs/learn/wallet/sweep.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Sweep Funds
 
 A sweep consolidates every UTXO in an account into one address. Two

diff --git a/docs/learn/wallet/sync-state.md b/docs/learn/wallet/sync-state.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Sync State
 
 "Sync" in the managed wallet covers two distinct layers:

diff --git a/docs/learn/wallet/transaction-history.md b/docs/learn/wallet/transaction-history.md
@@ -1,3 +1,8 @@
+---
+search:
+  boost: 3
+---
+
 # Transaction History
 
 The wallet stores a record of every transaction that touched each