@avacuscc/sdk 0.2.0 → 0.2.1

package/README.md

@@ -315,6 +315,27 @@ await client.gasAccount.useBalance({
 });
 ```
 
+Use balance from another owner's gas account via delegated spender permission:
+
+```ts
+await client.gasAccount.useBalance({
+  toAddress: '0x9876543210987654321098765432109876543210',
+  chainId: 97,
+  gasLimit: 21000,
+  gasPrice: 5,
+  sourceAddress: '0x610b463d2f57d2e0d9e785a7ff423fbae36f0624',
+  notes: 'Use gas from delegated source account',
+});
+```
+
+`sourceAddress` is important for delegated spending flows:
+
+- omit `sourceAddress` to spend from the currently authenticated user's own gas account
+- provide `sourceAddress` to spend from another owner's gas account
+- to make that possible, the owner must first authorize the caller with `registerWhitelistSpenders(...)` or one of the helper methods
+- the logged-in user must already be whitelisted as a spender for that `sourceAddress`
+- when `sourceAddress` is used, the returned balance payload reflects the source owner's balance
+
 Create sponsored transfer:
 
 ```ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@avacuscc/sdk",
-  "version": "0.2.0",
-  "description": "SDK for interacting with services in the Wakumo ecosystem",
+  "version": "0.2.1",
+  "description": "SDK for interacting with Avacuscc services",
   "main": "./packages/sdk/dist/index.js",
   "module": "./packages/sdk/dist/index.mjs",
   "types": "./packages/sdk/dist/index.d.ts",
@@ -22,8 +22,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup packages/sdk/src/index.ts packages/sdk/src/sns.ts --format cjs,esm --dts --clean --out-dir packages/sdk/dist",
-    "dev": "tsup packages/sdk/src/index.ts packages/sdk/src/sns.ts --format cjs,esm --dts --watch --out-dir packages/sdk/dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [],

package/packages/sdk/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { H as HttpAdapter, S as SnsService, B as BaseClientOptions } from './sns-Zwan9DNM.mjs';
-export { A as AVACUS_ENDPOINTS, a as AuthState, b as AvacusEnvironment, c as BASE_CONNECT_SIGNED_MSG, d as BASE_GAS_SPONSOR_SIGNED_MSG, e as BASE_REDIRECT_SIGNED_MSG, D as DEFAULT_BASE_SIGNED_MESSAGE, R as RequestOptions, f as ResolvedClientSettings, g as SNS_SERVICE_PATH, h as SignMessageFn, i as SnsAuthClient, j as SnsAuthClientOptions, k as SnsAuthTokenPayload, l as SnsAuthenticateParams, m as SnsAvatar, n as SnsCreateUserDeviceParams, o as SnsCreateUserParams, p as SnsCreateUserPayload, q as SnsCreateUserResult, r as SnsCreateUserWithSignatureParams, s as SnsDevice, t as SnsGetNonceParams, u as SnsGetProfilesParams, v as SnsLoginParams, w as SnsLoginResult, x as SnsNonceResponse, y as SnsProfile, z as SnsServiceName, C as SnsServiceOptions, E as isKnownAvacusBaseUrl, F as loginWithSns, G as resolveAvacusBaseUrl, I as resolveClientSettings, J as resolveServiceUrl } from './sns-Zwan9DNM.mjs';
+import { H as HttpAdapter, S as SnsService, B as BaseClientOptions } from './sns-NuV2JpAA.mjs';
+export { A as AVACUS_ENDPOINTS, a as AvacusEnvironment, b as BASE_CONNECT_SIGNED_MSG, c as BASE_GAS_SPONSOR_SIGNED_MSG, d as BASE_REDIRECT_SIGNED_MSG, D as DEFAULT_BASE_SIGNED_MESSAGE, R as ResolvedClientSettings, e as SNS_SERVICE_PATH, f as SignMessageFn, g as SnsAuthClient, h as SnsAuthClientOptions, i as SnsAuthTokenPayload, j as SnsAuthenticateParams, k as SnsAvatar, l as SnsCreateUserDeviceParams, m as SnsCreateUserParams, n as SnsCreateUserPayload, o as SnsCreateUserResult, p as SnsCreateUserWithSignatureParams, q as SnsDevice, r as SnsGetNonceParams, s as SnsGetProfilesParams, t as SnsLoginParams, u as SnsLoginResult, v as SnsNonceResponse, w as SnsProfile, x as SnsServiceName, y as SnsServiceOptions, z as isKnownAvacusBaseUrl, C as loginWithSns, E as resolveAvacusBaseUrl, F as resolveClientSettings, G as resolveServiceUrl } from './sns-NuV2JpAA.mjs';
 
 declare class BalancerService {
     private readonly http;
@@ -615,6 +615,9 @@ declare class GasAccountService {
     createDeposit(params: CreateDepositParams): Promise<CreateDepositResult>;
     /**
      * Creates a gas-usage request against the caller's balance or a whitelisted source address.
+      * When `sourceAddress` is provided, the caller spends from another owner's
+      * gas account and therefore must already be registered as a whitelist spender
+      * for that source account.
      *
      * @param params Usage request payload.
       *
@@ -627,6 +630,15 @@ declare class GasAccountService {
       *   gasPrice: 5,
       *   notes: 'Gas for token transfer',
       * });
+      *
+      * await client.gasAccount.useBalance({
+      *   toAddress: '0x9876543210987654321098765432109876543210',
+      *   chainId: 97,
+      *   gasLimit: 21000,
+      *   gasPrice: 5,
+      *   sourceAddress: '0x610b463d2f57d2e0d9e785a7ff423fbae36f0624',
+      *   notes: 'Use gas from delegated source account',
+      * });
       * ```
      */
     useBalance(params: UseBalanceParams): Promise<UseBalanceResult>;
@@ -706,4 +718,4 @@ declare class AvacusClient {
     constructor(options?: AvacusClientOptions);
 }
 
-export { type ApiEnvelope, type ApiEnvelopeWithMeta, AvacusClient, type AvacusClientOptions, BalancerService, BaseClientOptions, type BuildRegisterWhitelistSpendersTypedDataParams, type CancelGasAccountTransactionData, type CancelGasAccountTransactionResult, type ComputedBalance, type CreateDepositData, type CreateDepositParams, type CreateDepositResult, type CreateFundingRequestParams, type CreateFundingRequestResult, DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION, type EthersLikeTypedDataSigner, GAS_ACCOUNT_SERVICE_PATH, type GasAccountBalanceDetailedResult, type GasAccountBalanceDetailedSnapshot, type GasAccountBalanceResult, type GasAccountBalanceSnapshot, type GasAccountBalanceStatsData, type GasAccountBalanceStatsResult, type GasAccountEntity, GasAccountService, type GasAccountSummaryData, type GasAccountSummaryResult, type GasAccountTransaction, type GasAccountTransactionDetailData, type GasAccountTransactionDetailResult, type GasAccountTransactionListData, type GasAccountTransactionListParams, type GasAccountTransactionListResult, type GasAccountTransactionStatus, type GasAccountTransactionType, type GasAccountWhitelistData, type GasAccountWhitelistEntry, type GasAccountWhitelistResult, type GetMultipleBalancesParams, type GetMultipleBalancesResult, HttpAdapter, type NetworkRef, type PaginationMeta, type PendingBreakdown, type PendingTotals, type PendingTransactions, type RegisterWhitelistSpenderEntry, type RegisterWhitelistSpendersData, type RegisterWhitelistSpendersParams, type RegisterWhitelistSpendersResult, type RegisterWhitelistSpendersTypedData, type RegisterWhitelistSpendersTypedDataDomain, type RegisterWhitelistSpendersTypedDataMessage, type RegisterWhitelistSpendersWithEthersParams, type RegisterWhitelistSpendersWithSignatureParams, type RemoveWhitelistSpendersData, type RemoveWhitelistSpendersParams, type RemoveWhitelistSpendersResult, type SignRegisterWhitelistSpendersTypedDataFn, SnsService, type SponsorType, type SponsoredTransferAuthorization, type SponsoredTransferData, type SponsoredTransferParams, type SponsoredTransferResult, type StableToken, type StableTokenImage, type StableTokenListResult, type UseBalanceData, type UseBalanceParams, type UseBalanceResult };
+export { type ApiEnvelope, type ApiEnvelopeWithMeta, AvacusClient, type AvacusClientOptions, BalancerService, BaseClientOptions, type BuildRegisterWhitelistSpendersTypedDataParams, type CancelGasAccountTransactionData, type CancelGasAccountTransactionResult, type ComputedBalance, type CreateDepositData, type CreateDepositParams, type CreateDepositResult, type CreateFundingRequestParams, type CreateFundingRequestResult, DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION, type EthersLikeTypedDataSigner, GAS_ACCOUNT_SERVICE_PATH, type GasAccountBalanceDetailedResult, type GasAccountBalanceDetailedSnapshot, type GasAccountBalanceResult, type GasAccountBalanceSnapshot, type GasAccountBalanceStatsData, type GasAccountBalanceStatsResult, type GasAccountEntity, GasAccountService, type GasAccountSummaryData, type GasAccountSummaryResult, type GasAccountTransaction, type GasAccountTransactionDetailData, type GasAccountTransactionDetailResult, type GasAccountTransactionListData, type GasAccountTransactionListParams, type GasAccountTransactionListResult, type GasAccountTransactionStatus, type GasAccountTransactionType, type GasAccountWhitelistData, type GasAccountWhitelistEntry, type GasAccountWhitelistResult, type GetMultipleBalancesParams, type GetMultipleBalancesResult, type NetworkRef, type PaginationMeta, type PendingBreakdown, type PendingTotals, type PendingTransactions, type RegisterWhitelistSpenderEntry, type RegisterWhitelistSpendersData, type RegisterWhitelistSpendersParams, type RegisterWhitelistSpendersResult, type RegisterWhitelistSpendersTypedData, type RegisterWhitelistSpendersTypedDataDomain, type RegisterWhitelistSpendersTypedDataMessage, type RegisterWhitelistSpendersWithEthersParams, type RegisterWhitelistSpendersWithSignatureParams, type RemoveWhitelistSpendersData, type RemoveWhitelistSpendersParams, type RemoveWhitelistSpendersResult, type SignRegisterWhitelistSpendersTypedDataFn, SnsService, type SponsorType, type SponsoredTransferAuthorization, type SponsoredTransferData, type SponsoredTransferParams, type SponsoredTransferResult, type StableToken, type StableTokenImage, type StableTokenListResult, type UseBalanceData, type UseBalanceParams, type UseBalanceResult };

package/packages/sdk/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HttpAdapter, S as SnsService, B as BaseClientOptions } from './sns-Zwan9DNM.js';
-export { A as AVACUS_ENDPOINTS, a as AuthState, b as AvacusEnvironment, c as BASE_CONNECT_SIGNED_MSG, d as BASE_GAS_SPONSOR_SIGNED_MSG, e as BASE_REDIRECT_SIGNED_MSG, D as DEFAULT_BASE_SIGNED_MESSAGE, R as RequestOptions, f as ResolvedClientSettings, g as SNS_SERVICE_PATH, h as SignMessageFn, i as SnsAuthClient, j as SnsAuthClientOptions, k as SnsAuthTokenPayload, l as SnsAuthenticateParams, m as SnsAvatar, n as SnsCreateUserDeviceParams, o as SnsCreateUserParams, p as SnsCreateUserPayload, q as SnsCreateUserResult, r as SnsCreateUserWithSignatureParams, s as SnsDevice, t as SnsGetNonceParams, u as SnsGetProfilesParams, v as SnsLoginParams, w as SnsLoginResult, x as SnsNonceResponse, y as SnsProfile, z as SnsServiceName, C as SnsServiceOptions, E as isKnownAvacusBaseUrl, F as loginWithSns, G as resolveAvacusBaseUrl, I as resolveClientSettings, J as resolveServiceUrl } from './sns-Zwan9DNM.js';
+import { H as HttpAdapter, S as SnsService, B as BaseClientOptions } from './sns-NuV2JpAA.js';
+export { A as AVACUS_ENDPOINTS, a as AvacusEnvironment, b as BASE_CONNECT_SIGNED_MSG, c as BASE_GAS_SPONSOR_SIGNED_MSG, d as BASE_REDIRECT_SIGNED_MSG, D as DEFAULT_BASE_SIGNED_MESSAGE, R as ResolvedClientSettings, e as SNS_SERVICE_PATH, f as SignMessageFn, g as SnsAuthClient, h as SnsAuthClientOptions, i as SnsAuthTokenPayload, j as SnsAuthenticateParams, k as SnsAvatar, l as SnsCreateUserDeviceParams, m as SnsCreateUserParams, n as SnsCreateUserPayload, o as SnsCreateUserResult, p as SnsCreateUserWithSignatureParams, q as SnsDevice, r as SnsGetNonceParams, s as SnsGetProfilesParams, t as SnsLoginParams, u as SnsLoginResult, v as SnsNonceResponse, w as SnsProfile, x as SnsServiceName, y as SnsServiceOptions, z as isKnownAvacusBaseUrl, C as loginWithSns, E as resolveAvacusBaseUrl, F as resolveClientSettings, G as resolveServiceUrl } from './sns-NuV2JpAA.js';
 
 declare class BalancerService {
     private readonly http;
@@ -615,6 +615,9 @@ declare class GasAccountService {
     createDeposit(params: CreateDepositParams): Promise<CreateDepositResult>;
     /**
      * Creates a gas-usage request against the caller's balance or a whitelisted source address.
+      * When `sourceAddress` is provided, the caller spends from another owner's
+      * gas account and therefore must already be registered as a whitelist spender
+      * for that source account.
      *
      * @param params Usage request payload.
       *
@@ -627,6 +630,15 @@ declare class GasAccountService {
       *   gasPrice: 5,
       *   notes: 'Gas for token transfer',
       * });
+      *
+      * await client.gasAccount.useBalance({
+      *   toAddress: '0x9876543210987654321098765432109876543210',
+      *   chainId: 97,
+      *   gasLimit: 21000,
+      *   gasPrice: 5,
+      *   sourceAddress: '0x610b463d2f57d2e0d9e785a7ff423fbae36f0624',
+      *   notes: 'Use gas from delegated source account',
+      * });
       * ```
      */
     useBalance(params: UseBalanceParams): Promise<UseBalanceResult>;
@@ -706,4 +718,4 @@ declare class AvacusClient {
     constructor(options?: AvacusClientOptions);
 }
 
-export { type ApiEnvelope, type ApiEnvelopeWithMeta, AvacusClient, type AvacusClientOptions, BalancerService, BaseClientOptions, type BuildRegisterWhitelistSpendersTypedDataParams, type CancelGasAccountTransactionData, type CancelGasAccountTransactionResult, type ComputedBalance, type CreateDepositData, type CreateDepositParams, type CreateDepositResult, type CreateFundingRequestParams, type CreateFundingRequestResult, DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION, type EthersLikeTypedDataSigner, GAS_ACCOUNT_SERVICE_PATH, type GasAccountBalanceDetailedResult, type GasAccountBalanceDetailedSnapshot, type GasAccountBalanceResult, type GasAccountBalanceSnapshot, type GasAccountBalanceStatsData, type GasAccountBalanceStatsResult, type GasAccountEntity, GasAccountService, type GasAccountSummaryData, type GasAccountSummaryResult, type GasAccountTransaction, type GasAccountTransactionDetailData, type GasAccountTransactionDetailResult, type GasAccountTransactionListData, type GasAccountTransactionListParams, type GasAccountTransactionListResult, type GasAccountTransactionStatus, type GasAccountTransactionType, type GasAccountWhitelistData, type GasAccountWhitelistEntry, type GasAccountWhitelistResult, type GetMultipleBalancesParams, type GetMultipleBalancesResult, HttpAdapter, type NetworkRef, type PaginationMeta, type PendingBreakdown, type PendingTotals, type PendingTransactions, type RegisterWhitelistSpenderEntry, type RegisterWhitelistSpendersData, type RegisterWhitelistSpendersParams, type RegisterWhitelistSpendersResult, type RegisterWhitelistSpendersTypedData, type RegisterWhitelistSpendersTypedDataDomain, type RegisterWhitelistSpendersTypedDataMessage, type RegisterWhitelistSpendersWithEthersParams, type RegisterWhitelistSpendersWithSignatureParams, type RemoveWhitelistSpendersData, type RemoveWhitelistSpendersParams, type RemoveWhitelistSpendersResult, type SignRegisterWhitelistSpendersTypedDataFn, SnsService, type SponsorType, type SponsoredTransferAuthorization, type SponsoredTransferData, type SponsoredTransferParams, type SponsoredTransferResult, type StableToken, type StableTokenImage, type StableTokenListResult, type UseBalanceData, type UseBalanceParams, type UseBalanceResult };
+export { type ApiEnvelope, type ApiEnvelopeWithMeta, AvacusClient, type AvacusClientOptions, BalancerService, BaseClientOptions, type BuildRegisterWhitelistSpendersTypedDataParams, type CancelGasAccountTransactionData, type CancelGasAccountTransactionResult, type ComputedBalance, type CreateDepositData, type CreateDepositParams, type CreateDepositResult, type CreateFundingRequestParams, type CreateFundingRequestResult, DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION, type EthersLikeTypedDataSigner, GAS_ACCOUNT_SERVICE_PATH, type GasAccountBalanceDetailedResult, type GasAccountBalanceDetailedSnapshot, type GasAccountBalanceResult, type GasAccountBalanceSnapshot, type GasAccountBalanceStatsData, type GasAccountBalanceStatsResult, type GasAccountEntity, GasAccountService, type GasAccountSummaryData, type GasAccountSummaryResult, type GasAccountTransaction, type GasAccountTransactionDetailData, type GasAccountTransactionDetailResult, type GasAccountTransactionListData, type GasAccountTransactionListParams, type GasAccountTransactionListResult, type GasAccountTransactionStatus, type GasAccountTransactionType, type GasAccountWhitelistData, type GasAccountWhitelistEntry, type GasAccountWhitelistResult, type GetMultipleBalancesParams, type GetMultipleBalancesResult, type NetworkRef, type PaginationMeta, type PendingBreakdown, type PendingTotals, type PendingTransactions, type RegisterWhitelistSpenderEntry, type RegisterWhitelistSpendersData, type RegisterWhitelistSpendersParams, type RegisterWhitelistSpendersResult, type RegisterWhitelistSpendersTypedData, type RegisterWhitelistSpendersTypedDataDomain, type RegisterWhitelistSpendersTypedDataMessage, type RegisterWhitelistSpendersWithEthersParams, type RegisterWhitelistSpendersWithSignatureParams, type RemoveWhitelistSpendersData, type RemoveWhitelistSpendersParams, type RemoveWhitelistSpendersResult, type SignRegisterWhitelistSpendersTypedDataFn, SnsService, type SponsorType, type SponsoredTransferAuthorization, type SponsoredTransferData, type SponsoredTransferParams, type SponsoredTransferResult, type StableToken, type StableTokenImage, type StableTokenListResult, type UseBalanceData, type UseBalanceParams, type UseBalanceResult };

package/packages/sdk/dist/index.js

@@ -30,7 +30,6 @@ __export(index_exports, {
   DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION: () => DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION,
   GAS_ACCOUNT_SERVICE_PATH: () => GAS_ACCOUNT_SERVICE_PATH,
   GasAccountService: () => GasAccountService,
-  HttpAdapter: () => HttpAdapter,
   SNS_SERVICE_PATH: () => SNS_SERVICE_PATH,
   SnsAuthClient: () => SnsAuthClient,
   SnsService: () => SnsService,
@@ -616,6 +615,9 @@ var GasAccountService = class {
   }
   /**
    * Creates a gas-usage request against the caller's balance or a whitelisted source address.
+    * When `sourceAddress` is provided, the caller spends from another owner's
+    * gas account and therefore must already be registered as a whitelist spender
+    * for that source account.
    *
    * @param params Usage request payload.
     *
@@ -628,6 +630,15 @@ var GasAccountService = class {
     *   gasPrice: 5,
     *   notes: 'Gas for token transfer',
     * });
+    *
+    * await client.gasAccount.useBalance({
+    *   toAddress: '0x9876543210987654321098765432109876543210',
+    *   chainId: 97,
+    *   gasLimit: 21000,
+    *   gasPrice: 5,
+    *   sourceAddress: '0x610b463d2f57d2e0d9e785a7ff423fbae36f0624',
+    *   notes: 'Use gas from delegated source account',
+    * });
     * ```
    */
   async useBalance(params) {
@@ -952,7 +963,6 @@ var SnsAuthClient = class extends SnsService {
   DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION,
   GAS_ACCOUNT_SERVICE_PATH,
   GasAccountService,
-  HttpAdapter,
   SNS_SERVICE_PATH,
   SnsAuthClient,
   SnsService,

package/packages/sdk/dist/index.mjs

@@ -1,19 +1,188 @@
-import {
-  AVACUS_ENDPOINTS,
-  BASE_CONNECT_SIGNED_MSG,
-  BASE_GAS_SPONSOR_SIGNED_MSG,
-  BASE_REDIRECT_SIGNED_MSG,
-  DEFAULT_BASE_SIGNED_MESSAGE,
-  HttpAdapter,
-  SNS_SERVICE_PATH,
-  SnsAuthClient,
-  SnsService,
-  isKnownAvacusBaseUrl,
-  loginWithSns,
-  resolveAvacusBaseUrl,
-  resolveClientSettings,
-  resolveServiceUrl
-} from "./chunk-XWC6XZPN.mjs";
+// packages/sdk/src/config.ts
+var AVACUS_ENDPOINTS = {
+  prod: "https://apis.avacus.cc/",
+  dev: "https://apis.d.avscc.unit-hosting.net/",
+  stg: "https://apis.avacus.cc/stg/"
+};
+function resolveAvacusBaseUrl(options) {
+  if (options.baseUrl) {
+    return options.baseUrl;
+  }
+  return AVACUS_ENDPOINTS[options.env ?? "prod"];
+}
+function resolveClientSettings(options = {}) {
+  return {
+    env: options.env ?? "prod",
+    baseUrl: resolveAvacusBaseUrl(options),
+    headers: options.headers
+  };
+}
+function isKnownAvacusBaseUrl(baseUrl) {
+  return Object.values(AVACUS_ENDPOINTS).includes(baseUrl);
+}
+function resolveServiceUrl(baseUrl, servicePath) {
+  const normalizedServicePath = servicePath.endsWith("/") ? servicePath : `${servicePath}/`;
+  return new URL(normalizedServicePath, baseUrl).toString();
+}
+
+// packages/sdk/src/adapters/http.ts
+var HttpAdapter = class {
+  /**
+   * Creates a reusable HTTP transport bound to one service base URL.
+   *
+   * @param baseUrl Absolute base URL for the target service namespace.
+   * @param headers Default headers sent with every request.
+   * @param authState Shared mutable auth state so multiple adapters can reuse the same JWT.
+   */
+  constructor(baseUrl, headers = {}, authState = {}) {
+    this.baseUrl = baseUrl;
+    this.headers = headers;
+    this.authState = authState;
+  }
+  baseUrl;
+  headers;
+  authState;
+  /**
+   * Stores the JWT access token used by authenticated requests.
+   *
+   * @param accessToken JWT returned by the authentication flow.
+   */
+  setAccessToken(accessToken) {
+    this.authState.accessToken = accessToken;
+  }
+  /**
+   * Removes the currently stored JWT access token from shared auth state.
+   */
+  clearAccessToken() {
+    delete this.authState.accessToken;
+  }
+  /**
+   * Returns the currently stored JWT access token, if any.
+   */
+  getAccessToken() {
+    return this.authState.accessToken;
+  }
+  /**
+   * Sends an HTTP GET request to a path relative to this adapter base URL.
+   *
+   * @param path Relative endpoint path.
+   * @param options Request behavior such as auth requirement and extra headers.
+   */
+  async get(path, options = {}) {
+    const response = await fetch(this.buildUrl(path), {
+      method: "GET",
+      headers: this.buildHeaders(options)
+    });
+    return this.parseResponse(response, "GET", path);
+  }
+  /**
+   * Sends an HTTP POST request with a JSON body to a path relative to this adapter base URL.
+   *
+   * @param path Relative endpoint path.
+   * @param body Serializable request payload.
+   * @param options Request behavior such as auth requirement and extra headers.
+   */
+  async post(path, body, options = {}) {
+    const response = await fetch(this.buildUrl(path), {
+      method: "POST",
+      headers: this.buildHeaders({
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers
+        }
+      }),
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    return this.parseResponse(response, "POST", path);
+  }
+  /**
+   * Sends an HTTP PUT request with a JSON body to a path relative to this adapter base URL.
+   *
+   * @param path Relative endpoint path.
+   * @param body Serializable request payload.
+   * @param options Request behavior such as auth requirement and extra headers.
+   */
+  async put(path, body, options = {}) {
+    const response = await fetch(this.buildUrl(path), {
+      method: "PUT",
+      headers: this.buildHeaders({
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers
+        }
+      }),
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    return this.parseResponse(response, "PUT", path);
+  }
+  /**
+   * Sends an HTTP DELETE request with an optional JSON body to a path relative to this adapter base URL.
+   *
+   * @param path Relative endpoint path.
+   * @param body Optional serializable request payload.
+   * @param options Request behavior such as auth requirement and extra headers.
+   */
+  async delete(path, body, options = {}) {
+    const headers = body === void 0 ? this.buildHeaders(options) : this.buildHeaders({
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+    const response = await fetch(this.buildUrl(path), {
+      method: "DELETE",
+      headers,
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    return this.parseResponse(response, "DELETE", path);
+  }
+  /**
+   * Builds the final request headers by combining default headers, per-request
+   * headers, and an authorization header when the request requires auth.
+   */
+  buildHeaders(options) {
+    const accessToken = this.authState.accessToken;
+    if (options.auth && !accessToken) {
+      throw new Error("This request requires authentication. Call login() first.");
+    }
+    return {
+      ...this.headers,
+      ...options.headers,
+      ...options.auth && accessToken ? {
+        Authorization: `Bearer ${accessToken}`
+      } : {}
+    };
+  }
+  /**
+   * Resolves a relative path against the adapter base URL.
+   */
+  buildUrl(path) {
+    const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
+    return new URL(normalizedPath, this.baseUrl);
+  }
+  /**
+   * Parses a JSON response and converts non-2xx responses into descriptive errors.
+   */
+  async parseResponse(response, method, path) {
+    const bodyText = await response.text();
+    if (!response.ok) {
+      throw new Error(
+        `HTTP ${response.status} ${response.statusText} for ${method} ${path}: ${bodyText}`
+      );
+    }
+    try {
+      return JSON.parse(bodyText);
+    } catch (error) {
+      throw new Error(
+        `Invalid JSON response for ${method} ${path}: ${bodyText}`,
+        { cause: error }
+      );
+    }
+  }
+};
 
 // packages/sdk/src/services/balancer.ts
 var BalancerService = class {
@@ -403,6 +572,9 @@ var GasAccountService = class {
   }
   /**
    * Creates a gas-usage request against the caller's balance or a whitelisted source address.
+    * When `sourceAddress` is provided, the caller spends from another owner's
+    * gas account and therefore must already be registered as a whitelist spender
+    * for that source account.
    *
    * @param params Usage request payload.
     *
@@ -415,6 +587,15 @@ var GasAccountService = class {
     *   gasPrice: 5,
     *   notes: 'Gas for token transfer',
     * });
+    *
+    * await client.gasAccount.useBalance({
+    *   toAddress: '0x9876543210987654321098765432109876543210',
+    *   chainId: 97,
+    *   gasLimit: 21000,
+    *   gasPrice: 5,
+    *   sourceAddress: '0x610b463d2f57d2e0d9e785a7ff423fbae36f0624',
+    *   notes: 'Use gas from delegated source account',
+    * });
     * ```
    */
   async useBalance(params) {
@@ -497,6 +678,178 @@ var GasAccountService = class {
   }
 };
 
+// packages/sdk/src/services/sns.ts
+var DEFAULT_BASE_SIGNED_MESSAGE = "Hi there from Avacus Wallet! Please sign this message to prove that you can access to secure chat. To stop hackers access to your secure chat, do not sign this message outside Avacus Wallet, and here's a unique message ID they can't guess: ";
+var BASE_CONNECT_SIGNED_MSG = "Hi there from Avacus Connect! Please sign this message to prove that you can access our service. For security reasons, do not sign this message outside Avacus Connect, and here's a unique message ID they can't guess: ";
+var BASE_REDIRECT_SIGNED_MSG = "Hi there from Avacus Redirect! Please sign this message to prove that you can access our service. For security reasons, do not sign this message outside Avacus Redirect, and here's a unique message ID they can't guess: ";
+var BASE_GAS_SPONSOR_SIGNED_MSG = "Hi there from Avacus Gas Sponsor! Please sign this message to prove that you can access our service. For security reasons, do not sign this message outside Avacus Gas Sponsor, and here's a unique message ID they can't guess: ";
+var BASE_SIGNED_MESSAGE_BY_SERVICE = {
+  connect: BASE_CONNECT_SIGNED_MSG,
+  redirect: BASE_REDIRECT_SIGNED_MSG,
+  "gas-sponsor": BASE_GAS_SPONSOR_SIGNED_MSG
+};
+var SNS_SERVICE_PATH = "1/secure-chat/";
+var SnsService = class {
+  /**
+   * Creates the SNS service using a service-scoped HTTP adapter.
+   *
+   * @param http Adapter already configured for the SNS base path.
+   * @param options Optional SNS-specific behavior.
+   */
+  constructor(http, options = {}) {
+    this.http = http;
+    this.options = options;
+  }
+  http;
+  options;
+  /**
+   * Requests a one-time nonce used to construct the login signature message.
+   * This endpoint is public and does not require a JWT token.
+   *
+   * @param params Wallet identity used by the backend to mint a nonce.
+   */
+  async getNonce(params) {
+    const searchParams = new URLSearchParams({
+      wallet_address: params.walletAddress
+    });
+    return this.http.get(`v1/public/users/nonce?${searchParams.toString()}`);
+  }
+  /**
+   * Exchanges a signed message payload for an SNS auth token.
+   * This is the low-level authentication endpoint behind `login()`.
+   *
+   * @param params Payload expected by the SNS auth API.
+   */
+  async requestAuthToken(params) {
+    return this.http.post("v2/public/users/request_auth_token", params);
+  }
+  /**
+   * Returns public user profiles for a batch of wallet addresses and/or user IDs.
+   * This endpoint is public and does not require authentication.
+   *
+   * @param params Query payload with wallet addresses and/or user IDs.
+   */
+  async getPublicProfiles(params) {
+    return this.http.post("v1/public/users/profiles", {
+      wallets: params.wallets,
+      user_ids: params.userIds,
+      include_devices: params.includeDevices
+    });
+  }
+  /**
+   * Creates a new SNS user account using only the inputs the application already knows:
+   * wallet address, signer callback, and optional user profile metadata.
+   * The SDK internally fetches a nonce, builds the canonical message, requests
+   * the signature, and submits the create-user payload.
+   *
+   * @param params User creation payload in SDK-friendly camelCase format.
+   */
+  async createUser(params) {
+    const { walletAddress, signMessage } = params;
+    const { nonce } = await this.getNonce({ walletAddress });
+    const message = this.buildLoginMessage(nonce);
+    const signature = await signMessage(message);
+    return this.createUserWithSignature({
+      walletAddress,
+      message,
+      signature,
+      publicKey: params.publicKey,
+      displayName: params.displayName,
+      description: params.description,
+      device: params.device
+    });
+  }
+  /**
+   * Low-level create-user API for callers that already have a prepared message
+   * and signature and want direct control over the exact payload.
+   *
+   * @param params Signed create-user payload.
+   */
+  async createUserWithSignature(params) {
+    const result = await this.http.post(
+      "v1/public/users",
+      {
+        wallet_address: params.walletAddress,
+        message: params.message,
+        signature: params.signature,
+        public_key: params.publicKey,
+        display_name: params.displayName,
+        description: params.description,
+        device: params.device ? {
+          device_token: params.device.deviceToken,
+          app_name: params.device.appName,
+          app_version: params.device.appVersion,
+          platform: params.device.platform
+        } : void 0
+      }
+    );
+    const accessToken = extractAccessToken(result);
+    if (accessToken) {
+      this.http.setAccessToken(accessToken);
+    }
+    return result;
+  }
+  /**
+   * Adapts camelCase SDK parameters to the snake_case payload expected by the backend.
+   *
+   * @param params Wallet address, signed message, and signature returned by the signer.
+   */
+  async authenticate(params) {
+    return this.requestAuthToken({
+      wallet_address: params.walletAddress,
+      message: params.message,
+      signature: params.signature,
+      service_name: params.serviceName
+    });
+  }
+  /**
+   * Executes the full SNS login flow:
+   * 1. fetch nonce
+   * 2. build login message
+   * 3. sign message via injected signer callback
+   * 4. exchange signature for JWT
+   * 5. persist token in shared HTTP auth state
+   *
+   * @param params Wallet address and async signing callback.
+   */
+  async login(params) {
+    const { walletAddress, signMessage, serviceName } = params;
+    const { nonce } = await this.getNonce({ walletAddress });
+    const message = this.buildLoginMessage(nonce, serviceName);
+    const signature = await signMessage(message);
+    const result = await this.authenticate({
+      walletAddress,
+      message,
+      signature,
+      serviceName
+    });
+    const accessToken = extractAccessToken(result);
+    if (accessToken) {
+      this.http.setAccessToken(accessToken);
+    }
+    return result;
+  }
+  /**
+   * Builds the exact message string that the wallet must sign during login.
+   */
+  buildLoginMessage(nonce, serviceName) {
+    const baseMessage = serviceName != null ? BASE_SIGNED_MESSAGE_BY_SERVICE[serviceName] : this.options.baseSignedMessage ?? DEFAULT_BASE_SIGNED_MESSAGE;
+    return `${baseMessage}${nonce}`;
+  }
+};
+function extractAccessToken(result) {
+  if ("data" in result && typeof result.data === "object" && result.data !== null) {
+    const token = result.data.token;
+    if (typeof token === "string" && token.length > 0) {
+      return token;
+    }
+  }
+  return void 0;
+}
+async function loginWithSns(sns, params) {
+  return sns.login(params);
+}
+
 // packages/sdk/src/core/client.ts
 var AvacusClient = class {
   http;
@@ -531,6 +884,30 @@ var AvacusClient = class {
     this.balancer = new BalancerService(this.http);
   }
 };
+
+// packages/sdk/src/sns.ts
+var SnsAuthClient = class extends SnsService {
+  settings;
+  usingCustomBaseUrl;
+  constructor(options = {}) {
+    const settings = resolveClientSettings(options);
+    const http = new HttpAdapter(
+      resolveServiceUrl(settings.baseUrl, "1/secure-chat/"),
+      settings.headers
+    );
+    super(http, {
+      baseSignedMessage: options.baseSignedMessage
+    });
+    this.settings = settings;
+    this.usingCustomBaseUrl = !isKnownAvacusBaseUrl(settings.baseUrl);
+  }
+  getSettings() {
+    return { ...this.settings };
+  }
+  isUsingCustomBaseUrl() {
+    return this.usingCustomBaseUrl;
+  }
+};
 export {
   AVACUS_ENDPOINTS,
   AvacusClient,
@@ -542,7 +919,6 @@ export {
   DEFAULT_REGISTER_WHITELIST_SPENDERS_VERSION,
   GAS_ACCOUNT_SERVICE_PATH,
   GasAccountService,
-  HttpAdapter,
   SNS_SERVICE_PATH,
   SnsAuthClient,
   SnsService,

package/packages/sdk/dist/{sns-Zwan9DNM.d.mts → sns-NuV2JpAA.d.mts}

@@ -287,4 +287,4 @@ declare class SnsAuthClient extends SnsService {
     isUsingCustomBaseUrl(): boolean;
 }
 
-export { AVACUS_ENDPOINTS as A, type BaseClientOptions as B, type SnsServiceOptions as C, DEFAULT_BASE_SIGNED_MESSAGE as D, isKnownAvacusBaseUrl as E, loginWithSns as F, resolveAvacusBaseUrl as G, HttpAdapter as H, resolveClientSettings as I, resolveServiceUrl as J, type RequestOptions as R, SnsService as S, type AuthState as a, type AvacusEnvironment as b, BASE_CONNECT_SIGNED_MSG as c, BASE_GAS_SPONSOR_SIGNED_MSG as d, BASE_REDIRECT_SIGNED_MSG as e, type ResolvedClientSettings as f, SNS_SERVICE_PATH as g, type SignMessageFn as h, SnsAuthClient as i, type SnsAuthClientOptions as j, type SnsAuthTokenPayload as k, type SnsAuthenticateParams as l, type SnsAvatar as m, type SnsCreateUserDeviceParams as n, type SnsCreateUserParams as o, type SnsCreateUserPayload as p, type SnsCreateUserResult as q, type SnsCreateUserWithSignatureParams as r, type SnsDevice as s, type SnsGetNonceParams as t, type SnsGetProfilesParams as u, type SnsLoginParams as v, type SnsLoginResult as w, type SnsNonceResponse as x, type SnsProfile as y, type SnsServiceName as z };
+export { AVACUS_ENDPOINTS as A, type BaseClientOptions as B, loginWithSns as C, DEFAULT_BASE_SIGNED_MESSAGE as D, resolveAvacusBaseUrl as E, resolveClientSettings as F, resolveServiceUrl as G, HttpAdapter as H, type ResolvedClientSettings as R, SnsService as S, type AvacusEnvironment as a, BASE_CONNECT_SIGNED_MSG as b, BASE_GAS_SPONSOR_SIGNED_MSG as c, BASE_REDIRECT_SIGNED_MSG as d, SNS_SERVICE_PATH as e, type SignMessageFn as f, SnsAuthClient as g, type SnsAuthClientOptions as h, type SnsAuthTokenPayload as i, type SnsAuthenticateParams as j, type SnsAvatar as k, type SnsCreateUserDeviceParams as l, type SnsCreateUserParams as m, type SnsCreateUserPayload as n, type SnsCreateUserResult as o, type SnsCreateUserWithSignatureParams as p, type SnsDevice as q, type SnsGetNonceParams as r, type SnsGetProfilesParams as s, type SnsLoginParams as t, type SnsLoginResult as u, type SnsNonceResponse as v, type SnsProfile as w, type SnsServiceName as x, type SnsServiceOptions as y, isKnownAvacusBaseUrl as z };

package/packages/sdk/dist/{sns-Zwan9DNM.d.ts → sns-NuV2JpAA.d.ts}

@@ -287,4 +287,4 @@ declare class SnsAuthClient extends SnsService {
     isUsingCustomBaseUrl(): boolean;
 }
 
-export { AVACUS_ENDPOINTS as A, type BaseClientOptions as B, type SnsServiceOptions as C, DEFAULT_BASE_SIGNED_MESSAGE as D, isKnownAvacusBaseUrl as E, loginWithSns as F, resolveAvacusBaseUrl as G, HttpAdapter as H, resolveClientSettings as I, resolveServiceUrl as J, type RequestOptions as R, SnsService as S, type AuthState as a, type AvacusEnvironment as b, BASE_CONNECT_SIGNED_MSG as c, BASE_GAS_SPONSOR_SIGNED_MSG as d, BASE_REDIRECT_SIGNED_MSG as e, type ResolvedClientSettings as f, SNS_SERVICE_PATH as g, type SignMessageFn as h, SnsAuthClient as i, type SnsAuthClientOptions as j, type SnsAuthTokenPayload as k, type SnsAuthenticateParams as l, type SnsAvatar as m, type SnsCreateUserDeviceParams as n, type SnsCreateUserParams as o, type SnsCreateUserPayload as p, type SnsCreateUserResult as q, type SnsCreateUserWithSignatureParams as r, type SnsDevice as s, type SnsGetNonceParams as t, type SnsGetProfilesParams as u, type SnsLoginParams as v, type SnsLoginResult as w, type SnsNonceResponse as x, type SnsProfile as y, type SnsServiceName as z };
+export { AVACUS_ENDPOINTS as A, type BaseClientOptions as B, loginWithSns as C, DEFAULT_BASE_SIGNED_MESSAGE as D, resolveAvacusBaseUrl as E, resolveClientSettings as F, resolveServiceUrl as G, HttpAdapter as H, type ResolvedClientSettings as R, SnsService as S, type AvacusEnvironment as a, BASE_CONNECT_SIGNED_MSG as b, BASE_GAS_SPONSOR_SIGNED_MSG as c, BASE_REDIRECT_SIGNED_MSG as d, SNS_SERVICE_PATH as e, type SignMessageFn as f, SnsAuthClient as g, type SnsAuthClientOptions as h, type SnsAuthTokenPayload as i, type SnsAuthenticateParams as j, type SnsAvatar as k, type SnsCreateUserDeviceParams as l, type SnsCreateUserParams as m, type SnsCreateUserPayload as n, type SnsCreateUserResult as o, type SnsCreateUserWithSignatureParams as p, type SnsDevice as q, type SnsGetNonceParams as r, type SnsGetProfilesParams as s, type SnsLoginParams as t, type SnsLoginResult as u, type SnsNonceResponse as v, type SnsProfile as w, type SnsServiceName as x, type SnsServiceOptions as y, isKnownAvacusBaseUrl as z };

package/packages/sdk/dist/sns.d.mts

@@ -1 +1 @@
-export { A as AVACUS_ENDPOINTS, a as AuthState, b as AvacusEnvironment, c as BASE_CONNECT_SIGNED_MSG, d as BASE_GAS_SPONSOR_SIGNED_MSG, e as BASE_REDIRECT_SIGNED_MSG, D as DEFAULT_BASE_SIGNED_MESSAGE, H as HttpAdapter, R as RequestOptions, f as ResolvedClientSettings, h as SignMessageFn, i as SnsAuthClient, j as SnsAuthClientOptions, k as SnsAuthTokenPayload, l as SnsAuthenticateParams, m as SnsAvatar, n as SnsCreateUserDeviceParams, o as SnsCreateUserParams, p as SnsCreateUserPayload, q as SnsCreateUserResult, r as SnsCreateUserWithSignatureParams, s as SnsDevice, t as SnsGetNonceParams, u as SnsGetProfilesParams, v as SnsLoginParams, w as SnsLoginResult, x as SnsNonceResponse, y as SnsProfile, S as SnsService, z as SnsServiceName, C as SnsServiceOptions, F as loginWithSns } from './sns-Zwan9DNM.mjs';
+export { A as AVACUS_ENDPOINTS, a as AvacusEnvironment, b as BASE_CONNECT_SIGNED_MSG, c as BASE_GAS_SPONSOR_SIGNED_MSG, d as BASE_REDIRECT_SIGNED_MSG, D as DEFAULT_BASE_SIGNED_MESSAGE, R as ResolvedClientSettings, f as SignMessageFn, g as SnsAuthClient, h as SnsAuthClientOptions, i as SnsAuthTokenPayload, j as SnsAuthenticateParams, k as SnsAvatar, l as SnsCreateUserDeviceParams, m as SnsCreateUserParams, n as SnsCreateUserPayload, o as SnsCreateUserResult, p as SnsCreateUserWithSignatureParams, q as SnsDevice, r as SnsGetNonceParams, s as SnsGetProfilesParams, t as SnsLoginParams, u as SnsLoginResult, v as SnsNonceResponse, w as SnsProfile, S as SnsService, x as SnsServiceName, y as SnsServiceOptions, C as loginWithSns } from './sns-NuV2JpAA.mjs';