@unlink-xyz/core 0.1.6 → 0.1.8

package/dist/config.d.ts

@@ -3,6 +3,10 @@
  * Each maps to a full config (chainId, gateway, pool, artifacts).
  */
 export type SupportedChain = "monad-testnet" | "monad-testnet-staging";
+/**
+ * Default public RPC URLs per chain (not fetched from remote config).
+ */
+export declare const DEFAULT_RPC_URLS: Record<SupportedChain, string>;
 /**
  * Full configuration for a supported chain.
  */
@@ -11,8 +15,10 @@ export interface ChainConfig {
     gatewayUrl: string;
     frostUrl?: string;
     poolAddress: string;
+    adapterAddress?: string;
     artifactVersion: string;
     artifactBaseUrl?: string;
+    tokenAddresses?: Record<string, string>;
 }
 /**
  * Service configuration with broadcaster and indexer URLs.

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,uBAAuB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAuFD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,WAAW,CAAC,CAYtB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAMrE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,uBAAuB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAG3D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAqHD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,WAAW,CAAC,CAYtB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAMrE"}

package/dist/index.d.ts

@@ -16,13 +16,13 @@ export * from "./account/account.js";
 export * from "./keys/index.js";
 export * from "./history/index.js";
 export * from "./transactions/index.js";
-export { createServiceConfig, fetchChainConfig } from "./config.js";
+export { createServiceConfig, DEFAULT_RPC_URLS, fetchChainConfig, } from "./config.js";
 export type { ChainConfig, ServiceConfig, SupportedChain } from "./config.js";
 export * from "./clients/broadcaster.js";
 export * from "./clients/indexer.js";
 export { HttpError } from "./clients/http.js";
 export * from "./crypto/adapters/index.js";
-export { UnlinkWallet } from "./wallet/unlink-wallet.js";
+export { Unlink, UnlinkWallet } from "./wallet/unlink.js";
 export { encryptNote, deriveNpk, computeCommitment } from "./crypto/encrypt.js";
 export { createBrowserWalletSDK, createWalletSDK, type BrowserWalletOptions, type BrowserWalletResult, } from "./wallet/sdk.js";
 export type * from "./wallet/types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,mBAAmB,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,mBAAmB,mBAAmB,CAAC"}

package/dist/index.js

@@ -5568,6 +5568,10 @@ var Runtime = {
 };
 
 // config.ts
+var DEFAULT_RPC_URLS = {
+  "monad-testnet": "https://testnet-rpc.monad.xyz",
+  "monad-testnet-staging": "https://testnet-rpc.monad.xyz"
+};
 var CONFIG_URL = "https://config.unlink.xyz/networks.json";
 function parseRequiredString(chain, field, value) {
   if (typeof value !== "string" || value.trim().length === 0) {
@@ -5617,6 +5621,11 @@ function parseChainConfig(chain, value) {
     "artifactVersion",
     raw.artifactVersion
   ).replace(/^\/+|\/+$/g, "");
+  const adapterAddress = parseOptionalString(
+    chain,
+    "adapterAddress",
+    raw.adapterAddress
+  );
   const frostUrl = parseOptionalString(
     chain,
     "frostUrl",
@@ -5627,13 +5636,33 @@ function parseChainConfig(chain, value) {
     "artifactBaseUrl",
     raw.artifactBaseUrl
   )?.replace(/\/+$/, "");
+  let tokenAddresses;
+  if (raw.tokenAddresses !== void 0) {
+    if (raw.tokenAddresses === null || typeof raw.tokenAddresses !== "object" || Array.isArray(raw.tokenAddresses)) {
+      throw new InitializationError(
+        `Invalid SDK config for ${chain}: tokenAddresses must be an object`
+      );
+    }
+    tokenAddresses = {};
+    for (const [name, addr] of Object.entries(
+      raw.tokenAddresses
+    )) {
+      tokenAddresses[name] = parseRequiredString(
+        chain,
+        `tokenAddresses.${name}`,
+        addr
+      );
+    }
+  }
   return {
     chainId,
     gatewayUrl,
     ...frostUrl !== void 0 ? { frostUrl } : {},
     poolAddress,
+    ...adapterAddress !== void 0 ? { adapterAddress } : {},
     artifactVersion,
-    ...artifactBaseUrl !== void 0 ? { artifactBaseUrl } : { artifactBaseUrl: DEFAULT_ARTIFACT_BASE_URL }
+    ...artifactBaseUrl !== void 0 ? { artifactBaseUrl } : { artifactBaseUrl: DEFAULT_ARTIFACT_BASE_URL },
+    ...tokenAddresses !== void 0 ? { tokenAddresses } : {}
   };
 }
 async function fetchChainConfig(chain) {
@@ -7147,7 +7176,7 @@ function buildCall(params) {
   }
   return { to, data, value };
 }
-function buildApproveCall(token, spender, amount) {
+function approve(token, spender, amount) {
   const normalizedToken = ensureAddress("token", token);
   const normalizedSpender = ensureAddress("spender", spender);
   const normalizedAmount = ensureNonNegative("amount", amount);
@@ -7161,6 +7190,44 @@ function buildApproveCall(token, spender, amount) {
     value: 0n
   };
 }
+function toCall(tx) {
+  if (tx.to == null) {
+    throw new AdapterError("tx.to is required");
+  }
+  const to = ensureAddress("tx.to", tx.to);
+  if (tx.data == null) {
+    throw new AdapterError("tx.data is required");
+  }
+  const data = ensureHexData("tx.data", tx.data);
+  let value;
+  if (tx.value == null) {
+    value = 0n;
+  } else {
+    try {
+      value = BigInt(tx.value);
+    } catch {
+      throw new AdapterError(
+        `tx.value must be convertible to bigint, received: ${String(tx.value)}`
+      );
+    }
+  }
+  return { to, data, value: ensureNonNegative("tx.value", value) };
+}
+function contract(address, abi) {
+  const to = ensureAddress("contract.address", address);
+  const iface = new Interface3(abi);
+  return new Proxy(
+    {},
+    {
+      get(_, method) {
+        return (...args) => {
+          const data = iface.encodeFunctionData(method, args);
+          return { to, data, value: 0n };
+        };
+      }
+    }
+  );
+}
 function encodeAdapterExecute(params) {
   const transactCalldata = ensureHexData(
     "transactCalldata",
@@ -7184,6 +7251,7 @@ function encodeAdapterExecute(params) {
     deadline
   ]);
 }
+var buildApproveCall = approve;
 
 // transactions/note-selection.ts
 var MAX_CIRCUIT_INPUTS = Math.max(
@@ -8562,26 +8630,34 @@ function normalizeCall2(call, index) {
     value: call.value
   };
 }
-function normalizeInputSpec(input, index) {
-  const token = ensureAddress(`inputs[${index}].token`, input.token);
+function normalizeSpendInput(input, index) {
+  const token = ensureAddress(`spend[${index}].token`, input.token);
+  if (token.toLowerCase() === ETH_TOKEN.toLowerCase()) {
+    throw new AdapterError(
+      `spend[${index}].token: native ETH is not supported in adapter execution`
+    );
+  }
   if (input.amount <= 0n) {
-    throw new AdapterError(`inputs[${index}].amount must be greater than zero`);
+    throw new AdapterError(`spend[${index}].amount must be greater than zero`);
   }
   return {
     token,
     amount: input.amount
   };
 }
-function normalizeReshieldSpec(reshield, index) {
-  const token = ensureAddress(`reshields[${index}].token`, reshield.token);
-  if (reshield.minAmount < 0n) {
+function normalizeReceiveInput(receive, index) {
+  const token = ensureAddress(`receive[${index}].token`, receive.token);
+  if (token.toLowerCase() === ETH_TOKEN.toLowerCase()) {
     throw new AdapterError(
-      `reshields[${index}].minAmount must be non-negative`
+      `receive[${index}].token: native ETH is not supported in adapter execution`
     );
   }
+  if (receive.minAmount < 0n) {
+    throw new AdapterError(`receive[${index}].minAmount must be non-negative`);
+  }
   return {
     token,
-    minAmount: reshield.minAmount
+    minAmount: receive.minAmount
   };
 }
 function randomFieldElement(randomBigintFn) {
@@ -8601,41 +8677,41 @@ function createAdapterService(deps) {
         "adapterAddress",
         params.adapterAddress
       );
-      if (!params.inputs.length) {
-        throw new AdapterError("at least one input token is required");
+      if (!params.spend.length) {
+        throw new AdapterError("at least one spend token is required");
       }
       if (!params.calls.length) {
         throw new AdapterError("at least one adapter call is required");
       }
-      if (!params.reshields.length) {
-        throw new AdapterError("at least one reshield output is required");
+      if (!params.receive.length) {
+        throw new AdapterError("at least one receive output is required");
       }
-      const inputs = params.inputs.map(
-        (input, i) => normalizeInputSpec(input, i)
+      const spendInputs = params.spend.map(
+        (input, i) => normalizeSpendInput(input, i)
       );
       const seenTokens = /* @__PURE__ */ new Set();
-      for (const input of inputs) {
+      for (const input of spendInputs) {
         const lower = input.token.toLowerCase();
         if (seenTokens.has(lower)) {
           throw new AdapterError(
-            `duplicate input token ${input.token}; combine amounts per token instead`
+            `duplicate spend token ${input.token}; combine amounts per token instead`
           );
         }
         seenTokens.add(lower);
       }
       const calls = params.calls.map((call, i) => normalizeCall2(call, i));
-      const reshieldSpecs = params.reshields.map(
-        (reshield, i) => normalizeReshieldSpec(reshield, i)
+      const receiveSpecs = params.receive.map(
+        (receive, i) => normalizeReceiveInput(receive, i)
       );
-      const seenReshieldTokens = /* @__PURE__ */ new Set();
-      for (const r2 of reshieldSpecs) {
+      const seenReceiveTokens = /* @__PURE__ */ new Set();
+      for (const r2 of receiveSpecs) {
         const lower = r2.token.toLowerCase();
-        if (seenReshieldTokens.has(lower)) {
+        if (seenReceiveTokens.has(lower)) {
           throw new AdapterError(
-            `duplicate reshield token ${r2.token}; each reshield must target a unique token`
+            `duplicate receive token ${r2.token}; each receive must target a unique token`
           );
         }
-        seenReshieldTokens.add(lower);
+        seenReceiveTokens.add(lower);
       }
       const account = overrides?.account ?? await deps.requireActiveAccount();
       const signer = overrides?.signer ?? deps.requireSigner(account);
@@ -8645,19 +8721,19 @@ function createAdapterService(deps) {
         throw new AdapterError("deadline must be in the future");
       }
       const executionCalls = calls;
-      const reshields = reshieldSpecs.map(
-        (reshield) => {
+      const reshields = receiveSpecs.map(
+        (receive) => {
           const random = randomFieldElement(randomBigintImpl);
           const npk = poseidon([account.masterPublicKey, random]);
           return {
             npk,
             random,
-            token: reshield.token,
-            minAmount: reshield.minAmount
+            token: receive.token,
+            minAmount: receive.minAmount
           };
         }
       );
-      const inputTokens = inputs.map((input) => input.token);
+      const inputTokens = spendInputs.map((input) => input.token);
       const nonce = randomFieldElement(randomBigintImpl);
       const adapterDataHash = computeAdapterDataHash({
         calls: executionCalls,
@@ -8674,7 +8750,7 @@ function createAdapterService(deps) {
       });
       const withdrawalPlans = planWithdrawalsImpl(
         notes,
-        inputs.map((input) => ({
+        spendInputs.map((input) => ({
           token: input.token,
           amount: input.amount,
           recipient: adapterAddress
@@ -8757,7 +8833,7 @@ function createAdapterService(deps) {
         adapterCalldata,
         historyPreview: {
           kind: "Withdraw",
-          amounts: inputs.map((input) => ({
+          amounts: spendInputs.map((input) => ({
             token: input.token,
             delta: (-input.amount).toString()
           }))
@@ -8784,6 +8860,9 @@ import {
 } from "ethers";
 var BIP44_ETH_PREFIX = "m/44'/60'/0'/0";
 var ERC20_BALANCE_OF = "function balanceOf(address) view returns (uint256)";
+function isNativeToken(token) {
+  return token.toLowerCase() === ETH_TOKEN.toLowerCase();
+}
 function createBurnerService(deps) {
   const { chainRpcUrl, getMasterSeed, withdrawToAddress, requestDeposit } = deps;
   const provider = new JsonRpcProvider(chainRpcUrl);
@@ -8831,8 +8910,8 @@ function createBurnerService(deps) {
   }
   async function getTokenBalance(address, token) {
     const iface = new Interface4([ERC20_BALANCE_OF]);
-    const contract = new Contract(token, iface, provider);
-    const bal = await contract.getFunction("balanceOf")(address);
+    const contract2 = new Contract(token, iface, provider);
+    const bal = await contract2.getFunction("balanceOf")(address);
     return BigInt(bal ?? 0);
   }
   async function getBalance(address) {
@@ -8851,6 +8930,12 @@ function createBurnerService(deps) {
   }
   async function sweepToPool(index, params) {
     const { address } = await addressOf(index);
+    const native = isNativeToken(params.token);
+    if (native && params.amount == null) {
+      throw new Error(
+        "amount is required for native ETH sweeps (needed to reserve gas)"
+      );
+    }
     const amount = params.amount ?? await getTokenBalance(address, params.token);
     if (amount === 0n) {
       throw new Error("No token balance to sweep");
@@ -8861,17 +8946,20 @@ function createBurnerService(deps) {
       depositor: address,
       deposits: [{ token: params.token, amount }]
     });
-    const erc20Iface = new Interface4([
-      "function approve(address spender, uint256 amount)"
-    ]);
-    const approveData = erc20Iface.encodeFunctionData("approve", [
-      params.poolAddress,
-      amount
-    ]);
-    await send(index, { to: params.token, data: approveData });
+    if (!native) {
+      const erc20Iface = new Interface4([
+        "function approve(address spender, uint256 amount)"
+      ]);
+      const approveData = erc20Iface.encodeFunctionData("approve", [
+        params.poolAddress,
+        amount
+      ]);
+      await send(index, { to: params.token, data: approveData });
+    }
     const { txHash } = await send(index, {
       to: depositResult.to,
-      data: depositResult.calldata
+      data: depositResult.calldata,
+      value: depositResult.value
     });
     return { txHash };
   }
@@ -9581,21 +9669,27 @@ async function createBrowserWalletSDK(options) {
   };
 }
 
-// wallet/unlink-wallet.ts
-var UnlinkWallet = class _UnlinkWallet {
+// wallet/unlink.ts
+var Unlink = class _Unlink {
   /** @internal */
   sdk;
   /** Chain ID this wallet operates on. */
   chainId;
   /** Pool contract address this wallet transacts with. */
   poolAddress;
-  constructor(sdk, chainId, poolAddress) {
+  /** Adapter contract address for DeFi operations. */
+  adapterAddress;
+  constructor(sdk, chainId, poolAddress, adapterAddress) {
     this.sdk = sdk;
     this.chainId = chainId;
     this.poolAddress = poolAddress;
+    this.adapterAddress = adapterAddress;
+    this.adapter = {
+      address: adapterAddress
+    };
   }
   /**
-   * Create a new UnlinkWallet instance.
+   * Create a new Unlink instance.
    *
    * Handles all initialization internally:
    * - Resolves chain config (if using `chain` instead of explicit URLs)
@@ -9607,12 +9701,14 @@ var UnlinkWallet = class _UnlinkWallet {
     let chainId;
     let gatewayUrl;
     let poolAddress;
+    let adapterAddress;
     let proverConfig = config.prover;
     if ("chain" in config) {
       const chainConfig = await fetchChainConfig(config.chain);
       chainId = chainConfig.chainId;
       gatewayUrl = chainConfig.gatewayUrl;
       poolAddress = config.poolAddress ?? chainConfig.poolAddress;
+      adapterAddress = config.adapterAddress ?? chainConfig.adapterAddress;
       proverConfig = {
         artifactSource: {
           baseUrl: config.prover?.artifactSource?.baseUrl ?? chainConfig.artifactBaseUrl,
@@ -9624,6 +9720,7 @@ var UnlinkWallet = class _UnlinkWallet {
       chainId = config.chainId;
       gatewayUrl = config.gatewayUrl;
       poolAddress = config.poolAddress;
+      adapterAddress = config.adapterAddress;
       if (typeof window !== "undefined" && !config.prover?.artifactSource?.version) {
         throw new InitializationError(
           "prover.artifactSource.version is required in browser when using explicit gatewayUrl mode. Use chain mode or provide a pinned artifact version."
@@ -9644,7 +9741,7 @@ var UnlinkWallet = class _UnlinkWallet {
         autoSync: config.autoSync
       }
     );
-    return new _UnlinkWallet(sdk, chainId, poolAddress);
+    return new _Unlink(sdk, chainId, poolAddress, adapterAddress ?? "");
   }
   // ===== Seed Lifecycle =====
   /** Seed management (create, import, export, delete mnemonic). */
@@ -9675,10 +9772,10 @@ var UnlinkWallet = class _UnlinkWallet {
     return this.sdk.deposit.reconcile(relayId);
   }
   /**
-   * Execute a private transfer (1 or more recipients).
+   * Send a private transfer (1 or more recipients).
    * Handles note selection, circuit selection, and proof generation automatically.
    */
-  async transfer(params, overrides) {
+  async send(params, overrides) {
     return this.sdk.transfer.send(
       {
         chainId: this.chainId,
@@ -9689,9 +9786,9 @@ var UnlinkWallet = class _UnlinkWallet {
     );
   }
   /**
-   * Get a transfer plan without executing (for preview/confirmation UIs).
+   * Get a send plan without executing (for preview/confirmation UIs).
    */
-  async planTransfer(params, account) {
+  async planSend(params, account) {
     return this.sdk.transfer.plan(
       {
         chainId: this.chainId,
@@ -9701,8 +9798,8 @@ var UnlinkWallet = class _UnlinkWallet {
       account
     );
   }
-  /** Execute a pre-built transfer plan. */
-  async executeTransfer(plans, overrides) {
+  /** Execute a pre-built send plan. */
+  async executeSend(plans, overrides) {
     return this.sdk.transfer.execute(
       plans,
       { chainId: this.chainId, poolAddress: this.poolAddress },
@@ -9851,31 +9948,31 @@ var UnlinkWallet = class _UnlinkWallet {
       return this.sdk.burner.getBalance(address);
     }
   };
-  // ===== Adapter =====
+  // ===== Interact (Private DeFi) =====
   /**
-   * Private DeFi adapter operations.
-   * chainId/poolAddress are injected automatically.
+   * Adapter contract address (resolved from config).
+   * Use for building DeFi calls that reference the adapter.
    */
-  adapter = {
-    /**
-     * Execute an atomic unshield -> call(s) -> reshield flow through an adapter.
-     */
-    execute: (params, opts, overrides) => {
-      return this.sdk.adapter.execute(
-        {
-          chainId: this.chainId,
-          poolAddress: this.poolAddress,
-          adapterAddress: params.adapterAddress,
-          inputs: params.inputs,
-          calls: params.calls,
-          reshields: params.reshields,
-          deadline: params.deadline
-        },
-        opts,
-        overrides
-      );
-    }
-  };
+  adapter;
+  /**
+   * Execute an atomic unshield -> DeFi call(s) -> reshield flow through an adapter.
+   * chainId/poolAddress/adapterAddress are injected automatically.
+   */
+  async interact(params, opts, overrides) {
+    return this.sdk.adapter.execute(
+      {
+        chainId: this.chainId,
+        poolAddress: this.poolAddress,
+        adapterAddress: this.adapterAddress,
+        spend: params.spend,
+        calls: params.calls,
+        receive: params.receive,
+        deadline: params.deadline
+      },
+      opts,
+      overrides
+    );
+  }
   // ===== Advanced =====
   /**
    * Advanced escape hatch for raw JoinSplit transaction building.
@@ -9923,12 +10020,14 @@ var defaultRng = (n) => {
   }
   return globalThis.crypto.getRandomValues(new Uint8Array(n));
 };
+var UnlinkWallet = Unlink;
 export {
   ADAPTER_EXECUTE_ABI,
   AdapterError,
   CORE_SCHEMA_VERSION,
   CoreError,
   DEFAULT_JOB_TIMEOUT_MS,
+  DEFAULT_RPC_URLS,
   DEPOSIT_ABI,
   ETH_TOKEN,
   FieldSize,
@@ -9946,8 +10045,10 @@ export {
   ReconcileError,
   SNARK_SCALAR_FIELD,
   SchemaMismatchError,
+  Unlink,
   UnlinkWallet,
   ValidationError,
+  approve,
   assertNonNegative,
   buildApproveCall,
   buildCall,
@@ -9957,6 +10058,7 @@ export {
   computeCommitment,
   computeMasterPublicKey,
   computeNullifyingKey,
+  contract,
   createBroadcasterClient,
   createBrowserWalletSDK,
   createCiphertextStore,
@@ -10029,6 +10131,7 @@ export {
   syncDeposit,
   syncTransact,
   toAccountView,
+  toCall,
   transact,
   validateKey,
   verifySignature,