wative-core 2.5.6 → 2.5.8

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 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.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.
+
+### Added
+- A network's tokens are now an editable list — `network.assets` — with `add`, `update`, `drop`, `move` and `byId`.
+- Edit a token with `workspace.updateAsset(id, changes)` or `asset.save()`, and add one from its details with `workspace.addAsset(...)`; new types `AssetAddInit`, `AssetUpdate` and `NetworkAssetCollection`.
+
+### Changed
+- A built-in token may change only its display settings and cannot be removed; a user-added token may change every detail and be removed, and a token's id, contract address and network never change. `workspace.addAsset(asset)`, `workspace.dropAsset` and `workspace.moveAsset` are deprecated in favour of a network's token list.
+
 ## [2.5.6] — 2026-10-11
 
 Adds the Ink network and a portable, password-protected backup of an account's seed phrase, and tightens the rules for account and network names.

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.
 
@@ -607,22 +612,21 @@ await hd.setDefaultNetwork(Network.Base);
 ### Asset — pre-loaded tokens + custom tokens
 
 ```ts
-import { Asset, Network, type AssetId } from "wative-core";
+import { Network } from "wative-core";
 
 const ethAssets = await ws.assets(Network.Ethereum);
 console.log(ethAssets.map((a) => a.symbol));
 
-const myToken = new Asset({
-  id: 200 as AssetId,
+const eth = ws.networks.bySlug("ethereum");
+const pepe = await eth.assets.add({
   symbol: "PEPE",
   name: "Pepe",
   decimals: 18,
   contractAddress: "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
-  network: Network.Ethereum,
 });
-await ws.addAsset(myToken);
 
-await ws.dropAsset(200 as AssetId);
+await eth.assets.update(pepe.id, { displayStatus: false });
+await eth.assets.drop(pepe.id);
 
 const found  = await ws.filter("USDC", "Asset");
 const byAddr = await ws.filter("0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "Asset");