wative-core 2.5.7 → 2.5.9

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to `wative-core` are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.5.9] — 2026-10-14
+
+Adds `isBuiltin` on networks and tokens, keeps built-ins in step with the library, adds an SPL token-transfer shortcut and frozen / non-transferable destination warnings, and removes two balance-refresh forms that were never implemented.
+
+### Added
+- `network.isBuiltin` and `asset.isBuiltin` tell you whether a network or token ships with the library. A built-in cannot be removed and limits which fields you may edit — a network's connectivity and labels, a token's display settings.
+- `buildTransaction({ tokenMint })` builds a Solana SPL token transfer — the same transfer `buildTransferPayload` produces — without hand-built instructions; `tokenProgram` picks classic SPL or Token-2022.
+- `checkDestination` warns when an SPL recipient's token account is frozen or the token's mint is non-transferable, so you can tell before sending that the transfer would be rejected on-chain (codes `SVM_FROZEN_TOKEN_ACCOUNT`, `SVM_NON_TRANSFERABLE`).
+
+### Changed
+- Built-in networks and tokens stay in step with the library: ones added in a later release show up automatically in workspaces created earlier, and a built-in's details always match the library — your own changes to it (a network's RPC URL, a token's display settings) are kept.
+
+### Fixed
+- A built-in network that first appears in a workspace created before it existed now includes its built-in tokens; previously it showed no balances.
+
+### Removed
+- `address.refreshBalances(network, …)` and `address.refreshBalances(assetId)` are gone — they were never implemented and always failed. `address.refreshBalances()` reads the balances on the address's own network.
+
+## [2.5.8] — 2026-10-14
+
+Adds VM-agnostic wallet accessors and a built-in network's canonical RPC URL, and removes the unimplemented Sui placeholder.
+
+### Added
+- `wallet.vm` and `wallet.address` read a wallet without naming a chain: `wallet.vm` is the virtual machine of the account's default network, and `wallet.address` is that wallet's address for it. Changing the account's default network moves both. `wallet.address` is `null` when the wallet has no address for that chain. `wallet.evm` / `wallet.svm` remain for explicit per-chain access.
+- `network.defaultRpcUrl` is a built-in network's canonical RPC URL — the value an overridden built-in resets back to. A custom network has none and reports `UNSUPPORTED_OP`.
+
+### Removed
+- BREAKING: the unimplemented Sui placeholder is gone. A network's VM is now `evm` or `svm` only, and the `wallet.sui` accessor is removed. Register a chain the library does not ship with `registerDialect`.
+
 ## [2.5.7] — 2026-10-12
 
 Lets you add, edit, reorder and remove a network's tokens, and save the changes.

package/README.md

@@ -71,6 +71,11 @@ refuses the same identity twice, on either chain.
 > ```ts
 > const evm = wallet.addresses.find((a) => a.vm === "evm");
 > ```
+>
+> For the common case — a wallet's address on the account's **default network** —
+> skip the branch and read `wallet.vm` / `wallet.address`: `wallet.vm` is the
+> default network's chain and `wallet.address` is this wallet's address for it
+> (`null` if it has none). `wallet.evm` / `wallet.svm` stay for a named chain.
 
 **Which chain a key is for is read off the key** — `vm` is optional:
 
@@ -321,7 +326,7 @@ The library is organized around seven things you'll work with:
 - **`Account`** — either an HD account (one BIP-39 mnemonic, can derive many wallets) or a PK account (raw private keys you import one at a time). Each account can have its own password or share the workspace password.
 - **`Wallet`** — a unit inside an account, holding one address per `(vm, network)`. Both kinds give you an EVM and a Solana address: an HD slot derives one per chain from the mnemonic, an import derives its sibling from the imported key. Treat `wallet.addresses` as the list it is.
 - **`Address`** — an on-chain identity. Sign messages, build transactions, transfer native coins or tokens, and send them.
-- **`Network`** — chain metadata. 15 networks ship pre-loaded.
+- **`Network`** — chain metadata. 15 networks ship pre-loaded. A built-in network's `defaultRpcUrl` is its canonical endpoint — what a customized `rpcUrl` resets back to.
 - **`Asset`** — token metadata. 32 tokens ship pre-loaded.
 - **`Transaction`** — `EvmTransaction` or `SvmTransaction`. Subscribe to lifecycle events (`change` / `confirmed` / `failed`) or await terminal states (`whenSubmitted` / `whenMined` / `whenConfirmed` / `whenFinalized`). Tracking stops at first inclusion, so `whenConfirmed(n)` with `n > 1` rejects `UNSUPPORTED_OP` — call it with no argument and poll `receipt.blockNumber` against the chain head if you need depth — and `whenFinalized()` rejects `UNSUPPORTED_OP` unless the node reported finality directly.