wative-core 2.5.0 → 2.5.1

package/dist/{svm-Bi74PhrA.d.cts → svm-CjNIJZ4l.d.cts}

@@ -1,4 +1,4 @@
-import { c as Address, J as SvmTxBuildParams, I as SvmTransaction } from './workspace-ZNpsa6W7.cjs';
+import { c as Address, J as SvmTxBuildParams, I as SvmTransaction } from './workspace-DqUdScht.cjs';
 
 interface SvmInstruction {
     readonly programId: string;

package/dist/{svm-BQMaUXEA.d.ts → svm-D8zsWS64.d.ts}

@@ -1,4 +1,4 @@
-import { c as Address, J as SvmTxBuildParams, I as SvmTransaction } from './workspace-ZNpsa6W7.js';
+import { c as Address, J as SvmTxBuildParams, I as SvmTransaction } from './workspace-DqUdScht.js';
 
 interface SvmInstruction {
     readonly programId: string;

package/dist/{workspace-ZNpsa6W7.d.cts → workspace-DqUdScht.d.cts}

@@ -248,6 +248,18 @@ interface TransferRequest {
     asset?: AssetRef;
     amount: bigint;
 }
+
+type TransferPayload = {
+    readonly vm: "evm";
+    readonly to: string;
+    readonly value: bigint;
+    readonly data: string;
+} | {
+    readonly vm: "svm";
+    readonly recipient: string;
+    readonly amount: bigint;
+    readonly instructions?: ReadonlyArray<unknown>;
+};
 interface Transaction {
     readonly vm: VmToken;
     readonly status: TransactionStatus;
@@ -486,7 +498,7 @@ declare class Address {
     buildTransaction(params: EvmTxBuildParams): EvmTransaction;
     buildTransaction(params: SvmTxBuildParams): SvmTransaction;
     
-    transfer(req: TransferRequest): Transaction;
+    buildTransferPayload(req: TransferRequest): TransferPayload;
     
     signTransaction<T extends Transaction>(transaction: T): T;
     
@@ -799,4 +811,4 @@ declare class Workspace {
     } | null;
 }
 
-export { type WativeErrorOpts as $, Account as A, type SimulationResult as B, type ChainId as C, type SinkConfig as D, type EvmAddress as E, type Slug as F, type SvmAddress as G, SvmSigner as H, SvmTransaction as I, type SvmTxBuildParams as J, type TransactionReceipt as K, type LogLevel as L, type TransactionStateChange as M, Network as N, type OpenOptions as O, Provider as P, type TransactionStatus as Q, Record$1 as R, type Settling as S, type Transaction as T, type TransactionTracker as U, type TransferRequest as V, type VmToken as W, Wallet as X, type WalletCollection as Y, WativeError as Z, type WativeErrorCode as _, type AccountCollection as a, Workspace as a0, type WorkspaceConfig as a1, newMnemonic as a2, type SuiAddress as a3, 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, ConsoleSink as k, type ContainerState as l, type EvmRawTx as m, EvmSigner as n, EvmTransaction as o, type EvmTxBuildParams as p, EvmTxType as q, type LogRecord as r, type LogSink as s, Logger as t, type LoggerConfig as u, type NetworkCollection as v, type NetworkInit as w, type NetworkLike as x, type RecordInit as y, type RecordType as z };
+export { type WativeErrorCode as $, Account as A, type SimulationResult as B, type ChainId as C, type SinkConfig as D, type EvmAddress as E, type Slug as F, type SvmAddress as G, SvmSigner as H, SvmTransaction as I, type SvmTxBuildParams as J, type TransactionReceipt as K, type LogLevel as L, type TransactionStateChange as M, Network as N, type OpenOptions as O, Provider as P, type TransactionStatus as Q, Record$1 as R, type Settling as S, type Transaction as T, type TransactionTracker as U, type TransferPayload as V, type TransferRequest as W, type VmToken as X, Wallet as Y, type WalletCollection as Z, WativeError as _, type AccountCollection as a, type WativeErrorOpts as a0, Workspace as a1, type WorkspaceConfig as a2, newMnemonic as a3, type SuiAddress as a4, 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, ConsoleSink as k, type ContainerState as l, type EvmRawTx as m, EvmSigner as n, EvmTransaction as o, type EvmTxBuildParams as p, EvmTxType as q, type LogRecord as r, type LogSink as s, Logger as t, type LoggerConfig as u, type NetworkCollection as v, type NetworkInit as w, type NetworkLike as x, type RecordInit as y, type RecordType as z };

package/dist/{workspace-ZNpsa6W7.d.ts → workspace-DqUdScht.d.ts}

@@ -248,6 +248,18 @@ interface TransferRequest {
     asset?: AssetRef;
     amount: bigint;
 }
+
+type TransferPayload = {
+    readonly vm: "evm";
+    readonly to: string;
+    readonly value: bigint;
+    readonly data: string;
+} | {
+    readonly vm: "svm";
+    readonly recipient: string;
+    readonly amount: bigint;
+    readonly instructions?: ReadonlyArray<unknown>;
+};
 interface Transaction {
     readonly vm: VmToken;
     readonly status: TransactionStatus;
@@ -486,7 +498,7 @@ declare class Address {
     buildTransaction(params: EvmTxBuildParams): EvmTransaction;
     buildTransaction(params: SvmTxBuildParams): SvmTransaction;
     
-    transfer(req: TransferRequest): Transaction;
+    buildTransferPayload(req: TransferRequest): TransferPayload;
     
     signTransaction<T extends Transaction>(transaction: T): T;
     
@@ -799,4 +811,4 @@ declare class Workspace {
     } | null;
 }
 
-export { type WativeErrorOpts as $, Account as A, type SimulationResult as B, type ChainId as C, type SinkConfig as D, type EvmAddress as E, type Slug as F, type SvmAddress as G, SvmSigner as H, SvmTransaction as I, type SvmTxBuildParams as J, type TransactionReceipt as K, type LogLevel as L, type TransactionStateChange as M, Network as N, type OpenOptions as O, Provider as P, type TransactionStatus as Q, Record$1 as R, type Settling as S, type Transaction as T, type TransactionTracker as U, type TransferRequest as V, type VmToken as W, Wallet as X, type WalletCollection as Y, WativeError as Z, type WativeErrorCode as _, type AccountCollection as a, Workspace as a0, type WorkspaceConfig as a1, newMnemonic as a2, type SuiAddress as a3, 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, ConsoleSink as k, type ContainerState as l, type EvmRawTx as m, EvmSigner as n, EvmTransaction as o, type EvmTxBuildParams as p, EvmTxType as q, type LogRecord as r, type LogSink as s, Logger as t, type LoggerConfig as u, type NetworkCollection as v, type NetworkInit as w, type NetworkLike as x, type RecordInit as y, type RecordType as z };
+export { type WativeErrorCode as $, Account as A, type SimulationResult as B, type ChainId as C, type SinkConfig as D, type EvmAddress as E, type Slug as F, type SvmAddress as G, SvmSigner as H, SvmTransaction as I, type SvmTxBuildParams as J, type TransactionReceipt as K, type LogLevel as L, type TransactionStateChange as M, Network as N, type OpenOptions as O, Provider as P, type TransactionStatus as Q, Record$1 as R, type Settling as S, type Transaction as T, type TransactionTracker as U, type TransferPayload as V, type TransferRequest as W, type VmToken as X, Wallet as Y, type WalletCollection as Z, WativeError as _, type AccountCollection as a, type WativeErrorOpts as a0, Workspace as a1, type WorkspaceConfig as a2, newMnemonic as a3, type SuiAddress as a4, 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, ConsoleSink as k, type ContainerState as l, type EvmRawTx as m, EvmSigner as n, EvmTransaction as o, type EvmTxBuildParams as p, EvmTxType as q, type LogRecord as r, type LogSink as s, Logger as t, type LoggerConfig as u, type NetworkCollection as v, type NetworkInit as w, type NetworkLike as x, type RecordInit as y, type RecordType as z };

package/examples/20-custom-chain-dialect.test.cjs

@@ -48,10 +48,10 @@ class XvmDialect extends ChainDialect {
   buildTransaction(ctx, params) {
     return { vm: "xvm", from: String(ctx.publicKey), to: params.to, value: params.value ?? 0n, nonce: params.nonce ?? 0 };
   }
-  transfer(ctx, req) {
-    const tx = { vm: "xvm", from: String(ctx.publicKey), to: req.to, amount: req.amount };
-    if (req.asset && req.asset.address) tx.token = req.asset.address;
-    return tx;
+  buildTransferPayload(ctx, req) {
+    const payload = { vm: "xvm", from: String(ctx.publicKey), to: req.to, amount: req.amount };
+    if (req.asset && req.asset.address) payload.token = req.asset.address;
+    return payload;
   }
   derive(seed, index) {
     const h = toyHash(`${Buffer.from(seed).toString("hex")}:${index}`);
@@ -125,12 +125,12 @@ test("the custom dialect signs, builds a tx, and transfers via a keyless ctx", (
   assert.strictEqual(tx.to, "xvm1recipient");
   assert.strictEqual(tx.nonce, 7);
 
-  const native = dialect.transfer(ctx, { to: "xvm1bob", amount: 500n });
+  const native = dialect.buildTransferPayload(ctx, { to: "xvm1bob", amount: 500n });
   assert.strictEqual(native.to, "xvm1bob");
   assert.strictEqual(native.amount, 500n);
   assert.strictEqual(native.token, undefined);
 
-  const token = dialect.transfer(ctx, { to: "xvm1bob", asset: { address: "xtoken1" }, amount: 5n });
+  const token = dialect.buildTransferPayload(ctx, { to: "xvm1bob", asset: { address: "xtoken1" }, amount: 5n });
   assert.strictEqual(token.token, "xtoken1");
 });
 

package/examples/21-token-transfer.test.cjs

@@ -1,4 +1,4 @@
-// 21 — Token-aware transfer(): one intent lowered per chain — native, ERC-20 by address, SPL by mint, and by symbol. Built offline; amounts are raw base units.
+// 21 — Token-aware buildTransferPayload(): one intent lowered per chain into the buildTransaction payload — native value, ERC-20 by address, SPL by mint, and by symbol. Payload only (does not send); amounts are raw base units.
 
 const test = require("node:test");
 const assert = require("node:assert");
@@ -24,22 +24,22 @@ async function twoWallets() {
   return { ws, w0: acc.wallets[0], w1: acc.wallets[1] };
 }
 
-test("transfer() — native value on EVM and SVM (asset omitted)", async () => {
+test("buildTransferPayload() —native value on EVM and SVM (asset omitted)", async () => {
   const { ws, w0, w1 } = await twoWallets();
 
-  const evmTx = w0.evm.transfer({ to: String(w1.evm.publicKey), amount: 1_000_000_000_000_000n });
+  const evmTx = w0.evm.buildTransferPayload({ to: String(w1.evm.publicKey), amount: 1_000_000_000_000_000n });
   assert.strictEqual(String(evmTx.to).toLowerCase(), String(w1.evm.publicKey).toLowerCase());
   assert.strictEqual(evmTx.value, 1_000_000_000_000_000n);
 
-  const svmTx = w0.svm.transfer({ to: String(w1.svm.publicKey), amount: 5000n });
+  const svmTx = w0.svm.buildTransferPayload({ to: String(w1.svm.publicKey), amount: 5000n });
   assert.ok(svmTx);
 
   await ws.lock();
 });
 
-test("transfer() — EVM ERC-20 by contract address", async () => {
+test("buildTransferPayload() —EVM ERC-20 by contract address", async () => {
   const { ws, w0, w1 } = await twoWallets();
-  const tx = w0.evm.transfer({ to: String(w1.evm.publicKey), asset: { address: USDC_EVM }, amount: 1_000_000n });
+  const tx = w0.evm.buildTransferPayload({ to: String(w1.evm.publicKey), asset: { address: USDC_EVM }, amount: 1_000_000n });
 
   assert.strictEqual(String(tx.to).toLowerCase(), USDC_EVM.toLowerCase());
   assert.strictEqual(tx.value, 0n);
@@ -49,9 +49,9 @@ test("transfer() — EVM ERC-20 by contract address", async () => {
   await ws.lock();
 });
 
-test("transfer() — SVM SPL by mint prepends an idempotent recipient-ATA create", async () => {
+test("buildTransferPayload() —SVM SPL by mint prepends an idempotent recipient-ATA create", async () => {
   const { ws, w0, w1 } = await twoWallets();
-  const tx = w0.svm.transfer({ to: String(w1.svm.publicKey), asset: { address: USDC_SVM_MINT }, amount: 1_000_000n });
+  const tx = w0.svm.buildTransferPayload({ to: String(w1.svm.publicKey), asset: { address: USDC_SVM_MINT }, amount: 1_000_000n });
 
   assert.ok(Array.isArray(tx.instructions));
   assert.strictEqual(tx.instructions.length, 2);
@@ -59,23 +59,23 @@ test("transfer() — SVM SPL by mint prepends an idempotent recipient-ATA create
   await ws.lock();
 });
 
-test("transfer() — by token symbol resolves to native vs token", async () => {
+test("buildTransferPayload() —by token symbol resolves to native vs token", async () => {
   const { ws, w0, w1 } = await twoWallets();
 
-  const usdc = w0.evm.transfer({ to: String(w1.evm.publicKey), asset: { symbol: "USDC" }, amount: 1_000_000n });
+  const usdc = w0.evm.buildTransferPayload({ to: String(w1.evm.publicKey), asset: { symbol: "USDC" }, amount: 1_000_000n });
   assert.strictEqual(String(usdc.data).slice(0, 10), "0xa9059cbb");
 
-  const eth = w0.evm.transfer({ to: String(w1.evm.publicKey), asset: { symbol: "ETH" }, amount: 777n });
+  const eth = w0.evm.buildTransferPayload({ to: String(w1.evm.publicKey), asset: { symbol: "ETH" }, amount: 777n });
   assert.strictEqual(eth.value, 777n);
 
   await ws.lock();
 });
 
-test("transfer() — an out-of-range amount is a PARAMETER_ERROR", async () => {
+test("buildTransferPayload() —an out-of-range amount is a PARAMETER_ERROR", async () => {
   const { ws, w0, w1 } = await twoWallets();
   let code;
   try {
-    w0.evm.transfer({ to: String(w1.evm.publicKey), asset: { address: USDC_EVM }, amount: -1n });
+    w0.evm.buildTransferPayload({ to: String(w1.evm.publicKey), asset: { address: USDC_EVM }, amount: -1n });
   } catch (e) {
     code = e.code;
   }

package/examples/README.md

@@ -50,8 +50,8 @@ All tests work fully offline — no RPC calls, no real networks. Each test creat
 | [17-locked-state.test.cjs](17-locked-state.test.cjs) | What locking enforces — which operations refuse and with which error code, that a locked account holds no mnemonic in the clear, and that unlocking restores identical behaviour. |
 | [18-envelope-v3.test.cjs](18-envelope-v3.test.cjs) | `HybridProviderV3` — writing a workspace that derives one key for the whole workspace instead of one per stored secret, reopening it, and confirming a wrong password is still refused. |
 | [19-simple-provider.test.cjs](19-simple-provider.test.cjs) | The short way to write a storage backend — extend `ContainerProvider` and implement six methods that move bytes. Runs a whole workspace on a `Map`, signs from a derived address, reopens it, and checks that nothing readable reaches the store. |
-| [20-custom-chain-dialect.test.cjs](20-custom-chain-dialect.test.cjs) | Adding a whole new blockchain — subclass `ChainDialect` and `registerDialect` its vm, the same shape as extending `Provider`. A fictional `xvm` chain becomes a first-class network (and an unregistered vm is still refused), its dialect signs / builds a transaction / transfers / derives through the keyless `ChainCtx`, and `XvmSigner` names the per-chain signer just as `EvmSigner` / `SvmSigner` do. |
-| [21-token-transfer.test.cjs](21-token-transfer.test.cjs) | `address.transfer({ to, asset, amount })` — one intent lowered per chain: native value, EVM ERC-20 by contract address, SVM SPL by mint (with an idempotent recipient-ATA create), and by token `symbol`. All built offline; `amount` is raw base units. |
+| [20-custom-chain-dialect.test.cjs](20-custom-chain-dialect.test.cjs) | Adding a whole new blockchain — subclass `ChainDialect` and `registerDialect` its vm, the same shape as extending `Provider`. A fictional `xvm` chain becomes a first-class network (and an unregistered vm is still refused), its dialect signs / builds a transaction / builds transfer payloads / derives through the keyless `ChainCtx`, and `XvmSigner` names the per-chain signer just as `EvmSigner` / `SvmSigner` do. |
+| [21-token-transfer.test.cjs](21-token-transfer.test.cjs) | `address.buildTransferPayload({ to, asset, amount })` — one intent lowered per chain into the payload for `buildTransaction`: native value, EVM ERC-20 by contract address, SVM SPL by mint (with an idempotent recipient-ATA create), and by token `symbol`. Payload only (does not send); `amount` is raw base units. |
 
 ## Adapting for your project
 

package/package.json

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