wative-core 2.5.6 → 2.5.7

package/dist/{svm-BYbTqW4J.d.cts → svm-B88JqNxb.d.cts}

@@ -1,4 +1,4 @@
-import { c as Address, a5 as SvmTxBuildParams, a4 as SvmTransaction, N as Network, a2 as SvmAddressLookupTable } from './workspace-D7nb3-cO.cjs';
+import { c as Address, a8 as SvmTxBuildParams, a7 as SvmTransaction, N as Network, a5 as SvmAddressLookupTable } from './workspace-g-1DGOHJ.cjs';
 
 declare function svmResolveAddressLookupTables(network: Network, addresses: readonly string[]): Promise<SvmAddressLookupTable[]>;
 interface SvmInstruction {

package/dist/{svm-5rQU53_9.d.ts → svm-DYpcdzPR.d.ts}

@@ -1,4 +1,4 @@
-import { c as Address, a5 as SvmTxBuildParams, a4 as SvmTransaction, N as Network, a2 as SvmAddressLookupTable } from './workspace-D7nb3-cO.js';
+import { c as Address, a8 as SvmTxBuildParams, a7 as SvmTransaction, N as Network, a5 as SvmAddressLookupTable } from './workspace-g-1DGOHJ.js';
 
 declare function svmResolveAddressLookupTables(network: Network, addresses: readonly string[]): Promise<SvmAddressLookupTable[]>;
 interface SvmInstruction {

package/dist/{workspace-D7nb3-cO.d.cts → workspace-g-1DGOHJ.d.cts}

@@ -8,6 +8,24 @@ interface AssetInitObject {
     displayDecimals?: number;
     displayStatus?: boolean;
 }
+
+interface AssetUpdate {
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+    displayDecimals?: number;
+    displayStatus?: boolean;
+}
+
+interface AssetAddInit {
+    network: NetworkLike;
+    symbol: string;
+    name: string;
+    decimals: number;
+    contractAddress?: string | null;
+    displayDecimals?: number;
+    displayStatus?: boolean;
+}
 declare class Asset {
     readonly id: AssetId;
     readonly contractAddress: string | null;
@@ -20,6 +38,8 @@ declare class Asset {
     readonly network: Network;
     constructor(init: AssetInitObject);
     constructor(id: AssetId, symbol: string, name: string, decimals: number, network: Network, contractAddress?: string | null);
+    
+    save(): Promise<Asset>;
 }
 interface AssetBalance {
     readonly assetId: AssetId;
@@ -34,6 +54,13 @@ interface AssetCollection extends ReadonlyArray<Asset> {
     byId(id: AssetId): Asset | null;
 }
 
+interface NetworkAssetCollection extends AssetCollection {
+    add(init: Omit<AssetAddInit, "network">): Promise<Asset>;
+    update(id: AssetId, patch: AssetUpdate): Promise<Asset>;
+    drop(id: AssetId): Promise<void>;
+    move(id: AssetId, toIndex: number): Promise<void>;
+}
+
 interface NetworkRoutes {
     
     staked?: {
@@ -94,7 +121,7 @@ declare class Network {
     
     get symbol(): string;
     
-    readonly assets: readonly Asset[];
+    get assets(): NetworkAssetCollection;
     
     save(): Promise<void>;
     
@@ -1071,8 +1098,16 @@ declare class Workspace {
     
     assets(network: NetworkLike): Promise<readonly Asset[]>;
     
+    _networkAssets(network: Network): NetworkAssetCollection;
+    
     addAsset(asset: Asset): Promise<Asset>;
     
+    addAsset(init: AssetAddInit): Promise<Asset>;
+    
+    updateAsset(id: AssetId, patch: AssetUpdate): Promise<Asset>;
+    
+    _saveAsset(asset: Asset): Promise<Asset>;
+    
     dropAsset(id: AssetId): Promise<void>;
     
     moveAsset(network: NetworkLike, id: AssetId, toIndex: number): Promise<void>;
@@ -1088,4 +1123,4 @@ declare class Workspace {
     }>;
 }
 
-export { type SinkConfig as $, Account as A, type LogSink as B, type ChainId as C, type DecodedTx as D, type EvmAddress as E, Logger as F, type LoggerConfig as G, type NetworkCollection as H, type NetworkInit as I, type NetworkLike as J, type NetworkRoutes as K, type LogLevel as L, type NormalizedTx as M, Network as N, type OpenOptions as O, Provider as P, Record$1 as Q, type RawTx as R, type RecordInit as S, type RecordType as T, type SendOptions as U, type SendRoute as V, type Settling as W, type SignInParams as X, type SignInResult as Y, type SignRawOptions as Z, type SimulationResult as _, type AccountCollection as a, type Slug as a0, type SvmAddress as a1, type SvmAddressLookupTable as a2, SvmSigner as a3, SvmTransaction as a4, type SvmTxBuildParams as a5, type Transaction as a6, type TransactionReceipt as a7, type TransactionStateChange as a8, type TransactionStatus as a9, type TransactionTracker as aa, type TransferPayload as ab, type TransferRequest as ac, type VmToken as ad, Wallet as ae, type WalletCollection as af, WativeError as ag, type WativeErrorCode as ah, type WativeErrorOpts as ai, Workspace as aj, type WorkspaceConfig as ak, deserializeEvmTx as al, deserializeSvmTx as am, deserializeTx as an, isRawTx as ao, newMnemonic as ap, normalizeTxInput as aq, type SuiAddress as ar, type AccountOrgType as b, Address as c, Asset as d, type AssetBalance as e, type AssetCollection as f, type AssetId as g, type AssetInitObject as h, type AssetRef as i, type ChainVM as j, type Commitment as k, ConsoleSink as l, type ContainerState as m, type DestinationCode as n, type DestinationGuardOptions as o, type DestinationReport as p, type DestinationScreenResult as q, type DestinationScreener as r, type DestinationSeverity as s, type DestinationWarning as t, type EvmRawTx as u, EvmSigner as v, EvmTransaction as w, type EvmTxBuildParams as x, EvmTxType as y, type LogRecord as z };
+export { type SignInResult as $, Account as A, EvmTxType as B, type ChainId as C, type DecodedTx as D, type EvmAddress as E, type LogRecord as F, type LogSink as G, Logger as H, type LoggerConfig as I, type NetworkAssetCollection as J, type NetworkCollection as K, type LogLevel as L, type NetworkInit as M, Network as N, type NetworkLike as O, type NetworkRoutes as P, type NormalizedTx as Q, type OpenOptions as R, Provider as S, type RawTx as T, Record$1 as U, type RecordInit as V, type RecordType as W, type SendOptions as X, type SendRoute as Y, type Settling as Z, type SignInParams as _, type AccountCollection as a, type SignRawOptions as a0, type SimulationResult as a1, type SinkConfig as a2, type Slug as a3, type SvmAddress as a4, type SvmAddressLookupTable as a5, SvmSigner as a6, SvmTransaction as a7, type SvmTxBuildParams as a8, type Transaction as a9, type TransactionReceipt as aa, type TransactionStateChange as ab, type TransactionStatus as ac, type TransactionTracker as ad, type TransferPayload as ae, type TransferRequest as af, type VmToken as ag, Wallet as ah, type WalletCollection as ai, WativeError as aj, type WativeErrorCode as ak, type WativeErrorOpts as al, Workspace as am, type WorkspaceConfig as an, deserializeEvmTx as ao, deserializeSvmTx as ap, deserializeTx as aq, isRawTx as ar, newMnemonic as as, normalizeTxInput as at, type SuiAddress as au, type AccountOrgType as b, Address as c, Asset as d, type AssetAddInit as e, type AssetBalance as f, type AssetCollection as g, type AssetId as h, type AssetInitObject as i, type AssetRef as j, type AssetUpdate as k, type ChainVM as l, type Commitment as m, ConsoleSink as n, type ContainerState as o, type DestinationCode as p, type DestinationGuardOptions as q, type DestinationReport as r, type DestinationScreenResult as s, type DestinationScreener as t, type DestinationSeverity as u, type DestinationWarning as v, type EvmRawTx as w, EvmSigner as x, EvmTransaction as y, type EvmTxBuildParams as z };

package/dist/{workspace-D7nb3-cO.d.ts → workspace-g-1DGOHJ.d.ts}

@@ -8,6 +8,24 @@ interface AssetInitObject {
     displayDecimals?: number;
     displayStatus?: boolean;
 }
+
+interface AssetUpdate {
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+    displayDecimals?: number;
+    displayStatus?: boolean;
+}
+
+interface AssetAddInit {
+    network: NetworkLike;
+    symbol: string;
+    name: string;
+    decimals: number;
+    contractAddress?: string | null;
+    displayDecimals?: number;
+    displayStatus?: boolean;
+}
 declare class Asset {
     readonly id: AssetId;
     readonly contractAddress: string | null;
@@ -20,6 +38,8 @@ declare class Asset {
     readonly network: Network;
     constructor(init: AssetInitObject);
     constructor(id: AssetId, symbol: string, name: string, decimals: number, network: Network, contractAddress?: string | null);
+    
+    save(): Promise<Asset>;
 }
 interface AssetBalance {
     readonly assetId: AssetId;
@@ -34,6 +54,13 @@ interface AssetCollection extends ReadonlyArray<Asset> {
     byId(id: AssetId): Asset | null;
 }
 
+interface NetworkAssetCollection extends AssetCollection {
+    add(init: Omit<AssetAddInit, "network">): Promise<Asset>;
+    update(id: AssetId, patch: AssetUpdate): Promise<Asset>;
+    drop(id: AssetId): Promise<void>;
+    move(id: AssetId, toIndex: number): Promise<void>;
+}
+
 interface NetworkRoutes {
     
     staked?: {
@@ -94,7 +121,7 @@ declare class Network {
     
     get symbol(): string;
     
-    readonly assets: readonly Asset[];
+    get assets(): NetworkAssetCollection;
     
     save(): Promise<void>;
     
@@ -1071,8 +1098,16 @@ declare class Workspace {
     
     assets(network: NetworkLike): Promise<readonly Asset[]>;
     
+    _networkAssets(network: Network): NetworkAssetCollection;
+    
     addAsset(asset: Asset): Promise<Asset>;
     
+    addAsset(init: AssetAddInit): Promise<Asset>;
+    
+    updateAsset(id: AssetId, patch: AssetUpdate): Promise<Asset>;
+    
+    _saveAsset(asset: Asset): Promise<Asset>;
+    
     dropAsset(id: AssetId): Promise<void>;
     
     moveAsset(network: NetworkLike, id: AssetId, toIndex: number): Promise<void>;
@@ -1088,4 +1123,4 @@ declare class Workspace {
     }>;
 }
 
-export { type SinkConfig as $, Account as A, type LogSink as B, type ChainId as C, type DecodedTx as D, type EvmAddress as E, Logger as F, type LoggerConfig as G, type NetworkCollection as H, type NetworkInit as I, type NetworkLike as J, type NetworkRoutes as K, type LogLevel as L, type NormalizedTx as M, Network as N, type OpenOptions as O, Provider as P, Record$1 as Q, type RawTx as R, type RecordInit as S, type RecordType as T, type SendOptions as U, type SendRoute as V, type Settling as W, type SignInParams as X, type SignInResult as Y, type SignRawOptions as Z, type SimulationResult as _, type AccountCollection as a, type Slug as a0, type SvmAddress as a1, type SvmAddressLookupTable as a2, SvmSigner as a3, SvmTransaction as a4, type SvmTxBuildParams as a5, type Transaction as a6, type TransactionReceipt as a7, type TransactionStateChange as a8, type TransactionStatus as a9, type TransactionTracker as aa, type TransferPayload as ab, type TransferRequest as ac, type VmToken as ad, Wallet as ae, type WalletCollection as af, WativeError as ag, type WativeErrorCode as ah, type WativeErrorOpts as ai, Workspace as aj, type WorkspaceConfig as ak, deserializeEvmTx as al, deserializeSvmTx as am, deserializeTx as an, isRawTx as ao, newMnemonic as ap, normalizeTxInput as aq, type SuiAddress as ar, type AccountOrgType as b, Address as c, Asset as d, type AssetBalance as e, type AssetCollection as f, type AssetId as g, type AssetInitObject as h, type AssetRef as i, type ChainVM as j, type Commitment as k, ConsoleSink as l, type ContainerState as m, type DestinationCode as n, type DestinationGuardOptions as o, type DestinationReport as p, type DestinationScreenResult as q, type DestinationScreener as r, type DestinationSeverity as s, type DestinationWarning as t, type EvmRawTx as u, EvmSigner as v, EvmTransaction as w, type EvmTxBuildParams as x, EvmTxType as y, type LogRecord as z };
+export { type SignInResult as $, Account as A, EvmTxType as B, type ChainId as C, type DecodedTx as D, type EvmAddress as E, type LogRecord as F, type LogSink as G, Logger as H, type LoggerConfig as I, type NetworkAssetCollection as J, type NetworkCollection as K, type LogLevel as L, type NetworkInit as M, Network as N, type NetworkLike as O, type NetworkRoutes as P, type NormalizedTx as Q, type OpenOptions as R, Provider as S, type RawTx as T, Record$1 as U, type RecordInit as V, type RecordType as W, type SendOptions as X, type SendRoute as Y, type Settling as Z, type SignInParams as _, type AccountCollection as a, type SignRawOptions as a0, type SimulationResult as a1, type SinkConfig as a2, type Slug as a3, type SvmAddress as a4, type SvmAddressLookupTable as a5, SvmSigner as a6, SvmTransaction as a7, type SvmTxBuildParams as a8, type Transaction as a9, type TransactionReceipt as aa, type TransactionStateChange as ab, type TransactionStatus as ac, type TransactionTracker as ad, type TransferPayload as ae, type TransferRequest as af, type VmToken as ag, Wallet as ah, type WalletCollection as ai, WativeError as aj, type WativeErrorCode as ak, type WativeErrorOpts as al, Workspace as am, type WorkspaceConfig as an, deserializeEvmTx as ao, deserializeSvmTx as ap, deserializeTx as aq, isRawTx as ar, newMnemonic as as, normalizeTxInput as at, type SuiAddress as au, type AccountOrgType as b, Address as c, Asset as d, type AssetAddInit as e, type AssetBalance as f, type AssetCollection as g, type AssetId as h, type AssetInitObject as i, type AssetRef as j, type AssetUpdate as k, type ChainVM as l, type Commitment as m, ConsoleSink as n, type ContainerState as o, type DestinationCode as p, type DestinationGuardOptions as q, type DestinationReport as r, type DestinationScreenResult as s, type DestinationScreener as t, type DestinationSeverity as u, type DestinationWarning as v, type EvmRawTx as w, EvmSigner as x, EvmTransaction as y, type EvmTxBuildParams as z };

package/examples/05-asset-management.test.cjs

@@ -1,4 +1,4 @@
-// 05 — Assets: the pre-loaded tokens, adding, dropping, and searching via filter.
+// 05 — Assets: pre-loaded tokens, the live network.assets collection, adding, editing, persisting and dropping tokens, two-tier edits, and filter search.
 
 const test = require("node:test");
 const assert = require("node:assert");
@@ -8,6 +8,10 @@ const { join } = require("node:path");
 
 const { Workspace, Network, Asset } = require("wative-core");
 
+const PEPE_ADDR = "0x6982508145454Ce325dDbE47a25d4ec3d2311933";
+const SHIB_ADDR = "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE";
+const USDC_ADDR = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+
 test("asset — pre-loaded tokens per network", async () => {
   const root = mkdtempSync(join(tmpdir(), "wative-asset-builtin-"));
   const ws = await Workspace.open({ path: root, password: "wsp-pwd" });
@@ -31,73 +35,168 @@ test("asset — pre-loaded tokens per network", async () => {
   await ws.lock();
 });
 
-test("asset — add a custom user token", async () => {
+test("asset — add a custom token with addAsset(init); the library allocates the id", async () => {
   const root = mkdtempSync(join(tmpdir(), "wative-asset-add-"));
   const ws = await Workspace.open({ path: root, password: "wsp-pwd" });
 
-  const pepe = new Asset({
-    id: 200,
+  const pepe = await ws.addAsset({
+    network: Network.Ethereum,
     symbol: "PEPE",
     name: "Pepe",
     decimals: 18,
-    contractAddress: "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
-    network: Network.Ethereum,
+    contractAddress: PEPE_ADDR,
   });
-  await ws.addAsset(pepe);
+  assert.ok(pepe.id >= 1000);
 
   const ethAssets = await ws.assets(Network.Ethereum);
   assert.strictEqual(ethAssets.length, 5);
-  assert.ok(ethAssets.some((a) => a.id === 200 && a.symbol === "PEPE"));
+  assert.ok(ethAssets.some((a) => a.id === pepe.id && a.symbol === "PEPE"));
 
   await ws.lock();
 });
 
-test("asset — id and address collisions are rejected", async () => {
-  const root = mkdtempSync(join(tmpdir(), "wative-asset-collide-"));
+test("asset — network.assets is a live collection (add, byId, update, move, drop)", async () => {
+  const root = mkdtempSync(join(tmpdir(), "wative-asset-collection-"));
   const ws = await Workspace.open({ path: root, password: "wsp-pwd" });
 
-  const dupId = new Asset({
-    id: 1,
-    symbol: "FAKE",
-    name: "Fake",
+  const eth = ws.networks.bySlug("ethereum");
+  assert.ok(Array.isArray(eth.assets));
+  const before = eth.assets.length;
+
+  const added = await eth.assets.add({
+    symbol: "PEPE",
+    name: "Pepe",
     decimals: 18,
-    contractAddress: "0x1234567890123456789012345678901234567890",
-    network: Network.Ethereum,
+    contractAddress: PEPE_ADDR,
   });
-  await assert.rejects(ws.addAsset(dupId), (err) => err.code === "DUPLICATE_IDENTITY");
-
-  const dupAddr = new Asset({
-    id: 201,
-    symbol: "USDC2",
-    name: "Other USDC",
-    decimals: 6,
-    contractAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+  assert.ok(added.id >= 1000);
+  assert.strictEqual(eth.assets.length, before + 1);
+  assert.strictEqual(eth.assets.byId(added.id).symbol, "PEPE");
+
+  await eth.assets.update(added.id, { displayStatus: false });
+  assert.strictEqual(eth.assets.byId(added.id).displayStatus, false);
+
+  await eth.assets.move(added.id, 0);
+  assert.strictEqual(eth.assets[0].id, added.id);
+
+  await eth.assets.drop(added.id);
+  assert.strictEqual(eth.assets.byId(added.id), null);
+
+  await ws.lock();
+});
+
+test("asset — asset.save() persists an edit across reopen; a detached asset cannot save", async () => {
+  const root = mkdtempSync(join(tmpdir(), "wative-asset-save-"));
+  let ws = await Workspace.open({ path: root, password: "wsp-pwd" });
+
+  const eth = ws.networks.bySlug("ethereum");
+  const added = await eth.assets.add({
+    symbol: "PEPE",
+    name: "Pepe",
+    decimals: 18,
+    contractAddress: PEPE_ADDR,
+  });
+
+  const held = eth.assets.byId(added.id);
+  held.displayStatus = false;
+  held.name = "Pepe Token";
+  await held.save();
+
+  await ws.lock();
+  ws = await Workspace.open({ path: root, password: "wsp-pwd" });
+  const reopened = ws.networks.bySlug("ethereum").assets.byId(added.id);
+  assert.strictEqual(reopened.displayStatus, false);
+  assert.strictEqual(reopened.name, "Pepe Token");
+
+  const detached = new Asset({
+    id: 5000,
+    symbol: "DET",
+    name: "Detached",
+    decimals: 18,
+    contractAddress: SHIB_ADDR,
     network: Network.Ethereum,
   });
-  await assert.rejects(ws.addAsset(dupAddr), (err) => err.code === "DUPLICATE_IDENTITY");
+  await assert.rejects(detached.save(), (err) => err.code === "UNSUPPORTED_OP");
 
   await ws.lock();
 });
 
-test("asset — drop user token; pre-loaded tokens reject drop", async () => {
-  const root = mkdtempSync(join(tmpdir(), "wative-asset-drop-"));
+test("asset — two-tier edits: a user token edits all metadata, a built-in only its display fields", async () => {
+  const root = mkdtempSync(join(tmpdir(), "wative-asset-tier-"));
   const ws = await Workspace.open({ path: root, password: "wsp-pwd" });
 
-  const my = new Asset({
-    id: 300,
+  const eth = ws.networks.bySlug("ethereum");
+  const mine = await eth.assets.add({
     symbol: "MINE",
     name: "Mine",
     decimals: 18,
-    contractAddress: "0x1111111111111111111111111111111111111111",
-    network: Network.Ethereum,
+    contractAddress: PEPE_ADDR,
   });
-  await ws.addAsset(my);
-  await ws.dropAsset(300);
 
-  const ethAssets = await ws.assets(Network.Ethereum);
-  assert.ok(!ethAssets.some((a) => a.id === 300));
+  const updated = await ws.updateAsset(mine.id, {
+    symbol: "MINE2",
+    name: "My Token",
+    decimals: 8,
+    displayDecimals: 8,
+    displayStatus: false,
+  });
+  assert.strictEqual(updated.symbol, "MINE2");
+  assert.strictEqual(updated.decimals, 8);
+  assert.strictEqual(updated.displayStatus, false);
+
+  const usdc = eth.assets.find((a) => a.symbol === "USDC");
+  const builtinEdited = await ws.updateAsset(usdc.id, { displayStatus: false });
+  assert.strictEqual(builtinEdited.displayStatus, false);
+  await assert.rejects(ws.updateAsset(usdc.id, { symbol: "USDX" }), (err) => err.code === "PARAMETER_ERROR");
+
+  await ws.lock();
+});
+
+test("asset — a standalone network's assets are a read-only template", async () => {
+  const builtins = Network.Ethereum.assets;
+  assert.ok(builtins.length >= 4);
+  assert.ok(builtins.every((a) => a instanceof Asset));
+  assert.ok(builtins.find((a) => a.symbol === "ETH"));
+  await assert.rejects(
+    Network.Ethereum.assets.add({ symbol: "X", name: "X", decimals: 18, contractAddress: PEPE_ADDR }),
+    (err) => err.code === "UNSUPPORTED_OP",
+  );
+});
+
+test("asset — a duplicate contract address is rejected", async () => {
+  const root = mkdtempSync(join(tmpdir(), "wative-asset-collide-"));
+  const ws = await Workspace.open({ path: root, password: "wsp-pwd" });
+
+  await assert.rejects(
+    ws.addAsset({
+      network: Network.Ethereum,
+      symbol: "USDC2",
+      name: "Other USDC",
+      decimals: 6,
+      contractAddress: USDC_ADDR,
+    }),
+    (err) => err.code === "DUPLICATE_IDENTITY",
+  );
+
+  await ws.lock();
+});
+
+test("asset — drop a user token via network.assets; built-in tokens reject drop", async () => {
+  const root = mkdtempSync(join(tmpdir(), "wative-asset-drop-"));
+  const ws = await Workspace.open({ path: root, password: "wsp-pwd" });
+
+  const eth = ws.networks.bySlug("ethereum");
+  const my = await eth.assets.add({
+    symbol: "MINE",
+    name: "Mine",
+    decimals: 18,
+    contractAddress: PEPE_ADDR,
+  });
+  await eth.assets.drop(my.id);
+  assert.strictEqual(eth.assets.byId(my.id), null);
 
-  await assert.rejects(ws.dropAsset(1), (err) => err.code === "UNSUPPORTED_OP");
+  const ethId = eth.assets.find((a) => a.symbol === "ETH").id;
+  await assert.rejects(eth.assets.drop(ethId), (err) => err.code === "UNSUPPORTED_OP");
 
   await ws.lock();
 });

package/examples/08-persistence.test.cjs

@@ -6,7 +6,7 @@ const { mkdtempSync } = require("node:fs");
 const { tmpdir } = require("node:os");
 const { join } = require("node:path");
 
-const { Workspace, Network, Asset } = require("wative-core");
+const { Workspace, Network } = require("wative-core");
 
 const MNEMONIC =
   "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
@@ -70,19 +70,19 @@ test("persistence — custom user asset round-trips", async () => {
   const root = mkdtempSync(join(tmpdir(), "wative-persist-asset-"));
   let ws = await Workspace.open({ path: root, password: "wsp-pwd" });
 
-  await ws.addAsset(new Asset({
-    id: 250,
+  const added = await ws.addAsset({
+    network: Network.Ethereum,
     symbol: "PEPE",
     name: "Pepe",
     decimals: 18,
     contractAddress: "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
-    network: Network.Ethereum,
-  }));
+  });
+  const id = added.id;
 
   await ws.lock();
   ws = await Workspace.open({ path: root, password: "wsp-pwd" });
   const ethAssets = await ws.assets(Network.Ethereum);
-  const pepe = ethAssets.find((a) => a.id === 250);
+  const pepe = ethAssets.find((a) => a.id === id);
   assert.ok(pepe);
   assert.strictEqual(pepe.symbol, "PEPE");
   assert.strictEqual(pepe.decimals, 18);

package/examples/README.md

@@ -35,7 +35,7 @@ All tests work fully offline — no RPC calls, no real networks. Each test creat
 | [02-hd-account.test.cjs](02-hd-account.test.cjs) | HD-specific flows — deriving / slicing wallets, dumping the mnemonic, account-level passwords with `resetPassword`, round-trip across lock + reopen. |
 | [03-pk-account.test.cjs](03-pk-account.test.cjs) | PK accounts — creating from a private key, importing more keys, and the three key formats accepted (EVM hex, Solana base58, `solana-keygen` JSON) with the chain inferred from the key. Also shows each import producing an address on both chains, duplicate-import rejection, and dropping wallets. |
 | [04-network-management.test.cjs](04-network-management.test.cjs) | The 15 pre-loaded networks, adding a brand-new network, overriding a pre-loaded RPC URL via `update()`, dropping user networks, the built-in protection guard. |
-| [05-asset-management.test.cjs](05-asset-management.test.cjs) | The 32 pre-loaded tokens, adding a custom user token, id collision rejection, contract-address collision rejection, dropping user tokens, `workspace.filter(q, "Asset")` search. |
+| [05-asset-management.test.cjs](05-asset-management.test.cjs) | The 32 pre-loaded tokens, the live `network.assets` collection (add / byId / update / move / drop), adding a token with `addAsset(init)` (library-allocated id), editing and persisting with `asset.save()` and `workspace.updateAsset`, the built-in vs user two-tier edit rule, a standalone network's read-only assets, contract-address collision rejection, and `workspace.filter(q, "Asset")` search. |
 | [06-address-signing.test.cjs](06-address-signing.test.cjs) | Personal-message signing on EVM and Solana, building a transaction fully offline (no RPC). |
 | [07-custom-provider.test.cjs](07-custom-provider.test.cjs) | Taking over the record layer as well, by extending `Provider` rather than `ContainerProvider` — for storage that has its own encryption or its own idea of a record. Longer than [19](19-simple-provider.test.cjs); start there unless you need this. |
 | [08-persistence.test.cjs](08-persistence.test.cjs) | Round-trip across `lock()` + reopen — multiple accounts, user networks, custom assets, and logger configuration. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wative-core",
-  "version": "2.5.6",
+  "version": "2.5.7",
   "description": "Hyperscale crypto wallet management library — multi-workspace, multi-chain, originally designed for on-chain market makers",
   "type": "module",
   "main": "./dist/index.node.cjs",