@t2000/sdk 2.19.0 → 2.19.1

package/README.md

@@ -36,8 +36,11 @@ const agent = await T2000.create({ pin: 'my-secret' });
 const balance = await agent.balance();
 console.log(`$${balance.available} USDC available`);
 
-// Send USDC
+// Send USDC — recipient can be a 0x address, a SuiNS name, or a saved contact alias
 await agent.send({ to: '0x...', amount: 10 });
+await agent.send({ to: 'alex.sui', amount: 10 });    // SuiNS — resolved on-chain
+// Legacy contact aliases (~/.t2000/contacts.json) still work but emit a deprecation
+// warning on first use per process. Sunset target: next major SDK release.
 
 // Save (earn yield — auto-selects best rate via NAVI)
 await agent.save({ amount: 50 });
@@ -88,7 +91,8 @@ const agent = T2000.fromPrivateKey('suiprivkey1q...');
 |--------|-------------|---------|
 | `agent.address()` | Wallet Sui address | `string` |
 | `agent.balance()` | Available USDC + savings + gas reserve | `BalanceResponse` |
-| `agent.send({ to, amount, asset? })` | Transfer USDC to any Sui address | `SendResult` |
+| `agent.send({ to, amount, asset? })` | Transfer USDC (or other supported asset) to a 0x address, SuiNS name (`alex.sui`), or saved contact alias. Priority: hex > SuiNS > contact. `SendResult.suinsName` / `.contactName` flag which path resolved. | `SendResult` |
+| `agent.resolveRecipient(input)` | Public resolver — same hex / SuiNS / contact priority used by `send()`. Useful for dryRun previews where you need the resolved address before committing. | `{ address, suinsName?, contactName? }` |
 | `agent.receive({ amount?, currency?, memo?, label? })` | Generate payment request with Payment Kit URI (`sui:pay?...`), nonce for duplicate prevention | `PaymentRequest` |
 | `agent.save({ amount, asset?, protocol? })` | Deposit **USDC or USDsui** to NAVI savings (v0.51.0+). `asset` defaults to `'USDC'`. Auto-selects best rate or specify `protocol`. `amount` can be `'all'`. | `SaveResult` |
 | `agent.withdraw({ amount, asset? })` | Withdraw from savings. `amount` can be `'all'`. Optional `asset` (default: USDC; also supports USDsui plus legacy USDe / SUI). | `WithdrawResult` |
@@ -285,10 +289,11 @@ Swap uses Cetus Aggregator V3. Per-call `overlayFee` is opt-in — the SDK and C
 import { T2000Error } from '@t2000/sdk';
 
 try {
-  await agent.send({ to: '0x...', amount: 1000 });
+  await agent.send({ to: 'alex.sui', amount: 1000 });
 } catch (e) {
   if (e instanceof T2000Error) {
-    console.log(e.code);    // 'INSUFFICIENT_BALANCE'
+    console.log(e.code);
+    // 'INSUFFICIENT_BALANCE' | 'SUINS_NOT_REGISTERED' | 'CONTACT_NOT_FOUND' | …
     console.log(e.message); // Human-readable message
   }
 }

package/dist/index.cjs

@@ -6435,6 +6435,7 @@ var ContactManager = class {
     const existed = key in this.contacts;
     this.contacts[key] = { name, address: normalized };
     this.save();
+    warnContactsDeprecation();
     return { action: existed ? "updated" : "added" };
   }
   remove(name) {
@@ -6877,6 +6878,14 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
    * unregistered SuiNS names (vs. propagating the engine-style
    * `SuinsNotRegisteredError` — keeps the SDK's error surface
    * `T2000Error`-only, consistent with every other write helper).
+   *
+   * [S.279.1 / 2026-05-23 — patch v2.19.1] Promoted from `private` to
+   * `public` so MCP's `t2000_send` dryRun preview path can share the
+   * same resolution logic as the live execute path. Pre-2.19.1 the
+   * MCP dryRun called `agent.contacts.resolve(to)` directly, which
+   * rejected SuiNS names — preview-then-execute flows broke for
+   * `alex.sui`-style recipients. SSOT: never let preview and execute
+   * resolve the same input differently.
    */
   async resolveRecipient(input) {
     const trimmed = input.trim();