@zeroxyz/sdk 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to `@zeroxyz/sdk` will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) — with the pre-1.0 caveat that minor versions may include breaking changes.
 
+## 0.11.0
+
+### Added
+
+- **`client.wallet.import()`** — link an existing self-custody wallet to the session user by private key (`{ privateKey, makePrimary? }` → the linked wallet). 409s when the wallet is already linked to this or another profile. New export `ImportWalletOptions`. (ZERO-478)
+- **`client.wallet.setPrimary()` / `client.wallet.remove()`** — session-mode multi-wallet management: switch the primary payer wallet, or unlink a wallet (rejected for the primary wallet or a non-zero balance). New exports `SetPrimaryWalletOptions` / `RemoveWalletOptions`. (ZERO-478)
+- **`UserWalletDto.importedAt`** — set on wallets linked via `wallet.import()`, absent/null otherwise. (ZERO-478)
+
 ## 0.10.0
 
 ### Changed

package/README.md

@@ -223,14 +223,26 @@ const url = await client.wallet.fundingUrl({ amount: "10" });
 
 Poll `balance()` to decide when to top up. Then either open `fundingUrl()` yourself to refill the shared wallet — from an ops dashboard, a low-balance alert, or alongside a direct USDC transfer to the `wallet.address()` result — or hand the link to the end user. Either way the link is **single-use** and burns when opened, so generate it at the moment of funding and don't pre-open one you intend to give to someone else.
 
-In **session mode** (acting for a Zero user) the wallet is Zero-managed, and a couple more methods apply:
+In **session mode** (acting for a Zero user) wallets are managed server-side, and a few more methods apply:
 
 ```ts
 await client.wallet.list();      // every wallet linked to the session user
 await client.wallet.provision(); // create the user's managed wallet (idempotent)
+
+// Link an existing self-custody wallet by private key (0x prefix optional).
+// Pass makePrimary to have it pay for the user's calls from now on.
+const imported = await client.wallet.import({
+  privateKey: "0x…",
+  makePrimary: true,
+});
+
+// Switch which linked wallet is primary, or unlink one. remove() rejects the
+// primary wallet and any wallet holding a balance — reassign / drain first.
+await client.wallet.setPrimary({ walletAddress: imported.walletAddress });
+await client.wallet.remove({ walletAddress: "0x…" });
 ```
 
-`wallet.address()` covers the common case (resolve — or provision — the primary managed wallet); reach for `list()`/`provision()` directly only when you need the full wallet objects or explicit provisioning.
+`wallet.address()` covers the common case (resolve — or provision — the primary managed wallet); reach for the methods above when you need the full wallet objects, explicit provisioning, or multi-wallet management. Imported wallets carry an `importedAt` timestamp on the returned wallet objects.
 
 ## Namespaces
 
@@ -249,7 +261,9 @@ const { capabilities } = await client.search("translate text to french", {
 const cap = await client.capabilities.get("cap_abc");     // by uid
 const cap2 = await client.capabilities.get("z_Ab12cd.1"); // by search token
 
-// Wallet — balance + one-time funding URL. See "Wallet & funding" above.
+// Wallet — balance, one-time funding URL, and (session mode) multi-wallet
+// management: list / provision / import / setPrimary / remove. See
+// "Wallet & funding" above.
 const { amount } = await client.wallet.balance();
 const fundUrl    = await client.wallet.fundingUrl({ amount: "10" });
 

package/dist/{chunk-IFVGW4ZN.cjs → chunk-HKF4TRC6.cjs}

@@ -1952,7 +1952,7 @@ var clientFetch = async (client, url, opts = {}) => {
 
 // package.json
 var package_default = {
-  version: "0.10.0"};
+  version: "0.11.0"};
 
 // src/version.ts
 var SDK_VERSION = package_default.version;
@@ -2443,6 +2443,7 @@ var userWalletDtoSchema = zod.z.object({
   source: zod.z.enum(["self_custody", "privy_embedded"]),
   isPrimary: zod.z.boolean(),
   linkedAt: zod.z.union([zod.z.string(), zod.z.date()]).nullable().optional(),
+  importedAt: zod.z.union([zod.z.string(), zod.z.date()]).nullable().optional(),
   delegationGranted: zod.z.boolean(),
   signerQuorumId: zod.z.string().nullable(),
   // Per-transaction USDC cap in base units (6 dp). null = unlimited, 0 = free-only.
@@ -3228,6 +3229,48 @@ var Wallet = class {
     },
     userWalletDtoSchema
   );
+  // Link an existing self-custody wallet to the session user by private key.
+  // Session-only. 409s when the wallet is already linked (to this or another
+  // profile — the error message says which).
+  import = (opts) => request(
+    this.client,
+    {
+      method: "POST",
+      path: "/v1/users/me/wallets/import",
+      body: {
+        privateKey: opts.privateKey,
+        ...opts.makePrimary !== void 0 ? { makePrimary: opts.makePrimary } : {}
+      },
+      signal: opts.signal
+    },
+    userWalletDtoSchema
+  );
+  // Make one of the session user's linked wallets the primary payer.
+  // Session-only. 404s when the address isn't linked to the user.
+  setPrimary = (opts) => request(
+    this.client,
+    {
+      method: "PATCH",
+      path: "/v1/users/me/wallets/primary",
+      body: { walletAddress: opts.walletAddress },
+      signal: opts.signal
+    },
+    userWalletDtoSchema
+  );
+  // Unlink a wallet from the session user. Session-only. 409s on the primary
+  // wallet or a non-zero balance (the error message says which); 404s when
+  // the address isn't linked. Responds 204 — resolves to void.
+  remove = async (opts) => {
+    await request(
+      this.client,
+      {
+        method: "DELETE",
+        path: `/v1/users/me/wallets/${opts.walletAddress}`,
+        signal: opts.signal
+      },
+      zod.z.undefined()
+    );
+  };
   // Routes by identity: account mode signs EIP-191 against /v1/wallet/fund-url,
   // session mode hits /v1/users/me/fund-url (Bearer-authed, wallet resolved
   // server-side). Both honor `provider` (coinbase | stripe).
@@ -3785,5 +3828,5 @@ exports.normalizeTransportEnvelopeRequest = normalizeTransportEnvelopeRequest;
 exports.paymentHasAnchor = paymentHasAnchor;
 exports.tempoChainLabelFromId = tempoChainLabelFromId;
 exports.unwrapTransportEnvelope = unwrapTransportEnvelope;
-//# sourceMappingURL=chunk-IFVGW4ZN.cjs.map
-//# sourceMappingURL=chunk-IFVGW4ZN.cjs.map
+//# sourceMappingURL=chunk-HKF4TRC6.cjs.map
+//# sourceMappingURL=chunk-HKF4TRC6.cjs.map